README.adoc 1.8 KB

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