Hello,
In order to evaluate an alternative to generate the Tapestry website and
documentation, I set up a demo website using Tapx as a prototype. The
source files can be downloaded here
http://www.laliluna.de/download/tapx.zip and viewed here
http://tapestry.laliluna.de
The PoC is not about the style or layout but shows how working with a
static site generator looks like, how we can deal with the documentation
and news.
The underlying technology is Nanoc site generator
http://nanoc.stoneship.org/ and all content is written in Textile.
### Installation
a) Install Ruby and rubygems
Mac OS: It should be there already
Fedora Linux: yum install ruby
Windows: see http://www.ruby-lang.org/en/
b)
Use rubygems to install all required libraries
It should be 'gem install nanoc adsf RedCloth' on the command line.
nanoc is the site generator
adsf is a webserver you can fire up in all directores. It is used to
preview the website.
RedCloth is a Textile interpreter. Textile is the wiki like format, I
used for the content.
c)
Download the website.
http://www.laliluna.de/download/tapx.zip
d)
In a shell switch to the website directory
e)
Input the following command to build the website
nanoc compile
Start a webserver with the following command
nanoc view
Visit the website http://localhost:3000/
### Changing content
The content is in the content directory. Documentation and the tutorial
is placed in a subdirectory of content.
Edit the file 'content/about.html'
Add some thext
Build the website again using the command
nanoc compile
or the short version
nanoc co
Update your browser.
### Adding content
We are going to create a new item for the documentation.
nanoc ci documentation/service
Open the file content/documentation/service.html and add some text
Build the site using the following command. We add -f to force an update
of all pages.
nanoc co -f
### Adding news
Create a new item in news. Add the yyyy-MM-dd- prefix to the filename.
It contains the date of the news.
nanoc ci news/2010-04-23-greatnews
Build the site and force an update of all pages.
nanoc co -f
I hope you got a nice first impression.
--
Best Regards / Viele Grüße
Sebastian Hennebrueder
-----
Software Developer and Trainer for Hibernate / Java Persistence
http://www.laliluna.de
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
