C. Scott Andreas created CASSANDRA-14552:
--------------------------------------------
Summary: 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
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!
!blog-post.png!
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
