You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cassandra.apache.org by "Dinesh Joshi (JIRA)" <ji...@apache.org> on 2018/07/01 01:36:00 UTC
[jira] [Comment Edited] (CASSANDRA-14552) Website: Add Static
Blogging / Article Publishing to cassandra.apache.org
[ https://issues.apache.org/jira/browse/CASSANDRA-14552?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16528952#comment-16528952 ]
Dinesh Joshi edited comment on CASSANDRA-14552 at 7/1/18 1:35 AM:
------------------------------------------------------------------
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.
# Perhaps document that these contributions need to be made against svn - [https://svn.apache.org/repos/asf/cassandra/site/src/] I could not find a reference to this. Perhaps I was not looking in the right place?
was (Author: djoshi3):
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: commits-unsubscribe@cassandra.apache.org
For additional commands, e-mail: commits-help@cassandra.apache.org