[ 
https://issues.apache.org/jira/browse/STORM-452?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14108176#comment-14108176
 ] 

P. Taylor Goetz commented on STORM-452:
---------------------------------------

[~amontalenti], thanks for volunteering to help out with this.

It will be changing soon, as we will be moving the documentation (and possibly 
website) to the git repository, but for now the website/documentation lives in 
subversion:

https://svn.apache.org/repos/asf/incubator/storm/site/

To commit changes, you need committer karma. So to submit changes, you would 
need to attach patch files to JIRA (unlike our github workflow). As I 
mentioned, this will change.

Here are some rough steps to how to generate/debug the site:

Checkout the Storm svn repo (this only contains the website, not the code):

{code}
svn co https://svn.apache.org/repos/asf/incubator/storm storm-website
{code}

The site is statically generated using jekyll. I have version 1.3.1 installed, 
but newer versions may be okay. To install jekyll:

{code}
gem install jekyll -v ‘1.3.1’
{code}

To run the jekyll web server and have it regenerate automatically whenever any 
file changes:

{code}
cd storm-website/site
jekyll serve -w
{code}

You can view the site locally at:

http://localhost:4000

(by default, jekyll will write generated files to the “_site” directory. This 
is not under version control — only for local development.)

When you are ready to publish, generate the site to the “publish” directory:

{code}
jekyll build -d publish
{code}

The publish directory is under version control. Apache svnpubsub is setup to 
watch that directory and update the website whenever it changes.

To publish the changes just add/commit any new or modified files. 

> Update link to Perl multilang implementation
> --------------------------------------------
>
>                 Key: STORM-452
>                 URL: https://issues.apache.org/jira/browse/STORM-452
>             Project: Apache Storm (Incubating)
>          Issue Type: Documentation
>            Reporter: Dan Blanchard
>            Priority: Minor
>
> The current link on the [DSL and Multilang 
> adapters|https://storm.incubator.apache.org/documentation/DSLs-and-multilang-adapters.html]
>  page for IO::Storm is out of date.  I have recently taken over as the 
> maintainer, and now it actually works with the latest version of Storm.  
> Please link to my fork at https://github.com/dan-blanchard/io-storm
> Also, there's currently no link for the Python 
> [streamparse|https://github.com/Parsely/streamparse] module, which provides 
> both a more robust Python Multilang adapter than the included {{storm.py}} 
> and a bunch of handy utilities for creating Python Storm projects.



--
This message was sent by Atlassian JIRA
(v6.2#6252)

Reply via email to