2
0

README.adoc 1.3 KB

12345678910111213141516171819202122232425262728293031323334
  1. = jMonkeyEngine Documentation
  2. image:https://github.com/jMonkeyEngine/wiki/workflows/Build%20Docs/badge.svg[Status Badge, 175, 25]
  3. see link:https://wiki.jmonkeyengine.org[https://wiki.jmonkeyengine.org/]
  4. The project to store, edit, and generate the documentation of http://jmonkeyengine.org[jMonkeyEngine].
  5. The documentation `docs/modules/ROOT/pages` is editable :
  6. * Online via github (Edit link located on the top navbar of the Wiki + Pull Request)
  7. * Offline with the Atom editor, which includes a built in previewer and code editor. see link:https://wiki.jmonkeyengine.org/docs-wiki/3.4/atom_editor.html[Atom Editor for Wiki Editing]
  8. * Any text editor and browser program of your choice.
  9. * Setting up your own local Node.js environment.
  10. NOTE: Read the link:https://wiki.jmonkeyengine.org/docs-wiki/3.4/wiki_contributor.html[Wiki Contributions] document for details on how to contribute.
  11. == Build & Preview
  12. To set up the Antora environment, you'll need Nodejs (tested with node 12).
  13. From your local wiki directory.
  14. Run:
  15. ```
  16. npm install
  17. npm run buildDocs
  18. ```
  19. This will install the needed dependencies and run the static site generator. The documentation will be output to the directory `build/site`.
  20. To preview, navigate to the `build/site` directory and open the index.html file in your browser.
  21. See also: https://docs.antora.org/antora/2.3/preview-site/