Gang,
I think I have managed to wrestle the toolchain into submission now.
* Docs are written in plain text, inside src/docs, using AsciiDoc
format, see http://www.methods.co.nz/asciidoc/
* Snippet script (Python)
- Extract text from files.
- Can have intertwined Snippets, i.e. lines containing SNIPPET are
removed silently.
- Inserts a [...snip...] if there is a "pause" of the same Snippet
Example;
[snippet,java]
-----------
source=tutorials/introduction/tenminutes/src/main/java/org/qi4j/demo/tenminute/OrderEntity.java
tag=sideEffect
-----------
* Syntax Highlighting filter, via "source".
Example
[source,java]
-----------
public interface TravelPlan
{
// Domain methods, which are beyond the discussion at hand.
}
-----------
The GraphViz should also work, but I have not tested it.
I have also ported a bunch of the content, BUT not images!!!
Thien has promised to help us create a good looking style for the
online content. I just need to send him a batch of generated content
to style against.
The PDF generation is not done yet.
Other things missing; MORE CONTENT. No more excuses, everyone... Start
documenting your work. I'll help make it turn out alright.
Finally; Neo4j has an awesome "Version Switcher", which I have not
looked at yet. A piece of Javascript to quickly navigate different
versions of the documentation, in case one is not on bleeding edge.
Cheers
--
Niclas Hedhman, Software Developer
http://www.qi4j.org - New Energy for Java
I live here; http://tinyurl.com/3xugrbk
I work here; http://tinyurl.com/6a2pl4j
I relax here; http://tinyurl.com/2cgsug
_______________________________________________
qi4j-dev mailing list
[email protected]
http://lists.ops4j.org/mailman/listinfo/qi4j-dev
