README.adoc 1.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950
  1. = jMonkeyEngine Documentation
  2. WARNING: The project is an experimental WIP for the documentation of jME3
  3. see http://jmonkeyengine.github.io/wiki/documentation
  4. The project to store, edit, and generate the documentation of http://jmonkeyengine.org[jMonkeyEngine]
  5. The documentation (<<src/docs/asciidoc>>) is editable :
  6. * online via github (Edit button + PR)
  7. * offline, after local `git clone` + ....
  8. The syntax is asciidoc :
  9. * http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/[Asciidoc Syntax Quick Reference]
  10. == Contribute
  11. TODO
  12. == Build
  13. Convert the AsciiDoc to HTML5 by invoking the 'asciidoctor' goal:
  14. $ ./gradlew asciidoctor
  15. Open the file _build/asciidoc/html5/index.html_ in your browser to see the generated HTML file.
  16. == TODO
  17. - [ ] configure travis build
  18. - [ ] configure github + gradle + travis to publish on gh-pages branches
  19. - [ ] find and fixe conversion bug
  20. - [ ] complete conversion: note, warning, ...
  21. - [ ] fix warning during html's generation
  22. - [ ] add meta info during conversion (doctitle, revision, tags, ...)
  23. - [ ] add a home page (index.html)
  24. - [ ] add a navigation bar or a menu (?)
  25. - [ ] customize html layout (header, footer, css)
  26. - [ ] transfer ownership to jMonkeyEngine org
  27. - [ ] complete Doc, how to contribute,...
  28. - [ ] accept PR
  29. - [ ] write a post about the migration (the tools, why asciidoc, ...)
  30. - [ ] generate sitemap
  31. - [ ] add search box
  32. - [ ] add google analytics (?)
  33. - [ ] support emoji
  34. - [ ] optimize remove useless images
  35. - [ ] optimize image, use smaller file, eg convert to jpg or to webp, resize