[
https://issues.apache.org/jira/browse/CASSANDRA-14552?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16528952#comment-16528952
]
Dinesh Joshi commented on CASSANDRA-14552:
------------------------------------------
Hey [~cscotta], this looks great. {{make serve}} seems to fail for me. I do
have jekyll installed as you can see below -
{noformat}
18:28 $ make serve
make: jekyll: No such file or directory
make: *** [serve] Error 1
18:28 $ jekyll --version
jekyll 3.4.3{noformat}
A few suggestions -
# A Docker container would make it super easy to setup the environment and
make it a low bar to update the toolset. Perhaps consider adding one and
publishing it to Docker Hub?
# Add macOS specific installation instructions using homebrew made it super
easy to acquire ruby, rubyenv, etc.
> Website: Add Static Blogging / Article Publishing to cassandra.apache.org
> -------------------------------------------------------------------------
>
> Key: CASSANDRA-14552
> URL: https://issues.apache.org/jira/browse/CASSANDRA-14552
> Project: Cassandra
> Issue Type: Improvement
> Components: Documentation and Website
> Reporter: C. Scott Andreas
> Assignee: C. Scott Andreas
> Priority: Minor
> Attachments: blog-post-listing.png, blog-post.png, blog.diff
>
>
> To make it easier for members of the community to share what's happening in
> Apache Cassandra, advertise meetups, and publish other article-style content,
> this patch enables simple blogging functionality via the static
> cassandra.apache.org site.
>
> *How does it work?*
> The patch uses Jekyll's built-in static blog functionality to add
> article-style publishing. It adds no dynamic content, and does not include
> commenting or a mechanism for accepting any user-generated content. It makes
> the following changes:
> – Adds a new layout file for a blog post listing and single-post detail view
> (+ supporting CSS).
> – Enables pagination of posts via `jekyll-paginate-v2`
> – Adds documentation on how to contribute.
> – And fixes a minor documentation issue specifying a Ruby version that
> conflicts with earlier guidance in the documentation.
>
> *How do I write a post?*
> The patch includes a /_templates folder with an example post to begin. Blog
> posts are written using Markdown. To write a new post, copy the template into
> /_posts, rename the file in keeping with the
> `MM-DD-YYYY-blog-post-slug.markdown` convention, add the title/date, and
> begin writing.
> These pages are generated via the existing build process documented in the
> README – `make serve` to preview, `make` to publish.
>
> *What else should I know?*
> The aim of this patch is to make it easy to write and publish. The "/blog"
> link is currently hidden from the top nav and no posts are included in this
> patch, but this can be enabled once the first article is ready.
>
> *What's it look like?*
> Screenshots of the generated post list view and single-post view attached.
> !blog-post-listing.png|width=592,height=619!
>
> !blog-post.png|width=592,height=619!
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
