tree: d74ae3815d0fc4e9066e86bbb83b61e8596cadc3 [path history] [tgz]
  1. .settings/
  2. eclipse-help/
  3. featuremodel/
  4. META-INF/
  5. online-doc/
  6. src/
  7. targets/
  8. .classpath
  9. .gitignore
  10. .project
  11. build.properties
  12. make.xml
  13. make.xml.launch
  14. plugin.xml
  15. project_structure.svg
  16. README.md
  17. run_online-doc.xml
  18. run_online-doc.xml.launch
plugins/org.eclipse.etrice.doc/README.md

eTrice documentation + help

Prerequistes:

  • Featurizer (Download from Bitbucket and install)
  • Stagen (Download .jar from Bitbucket and put it to folder /xternalLibs, **Java 8 **)

Project Structure

commented screenshot

Artifacts

Feature model, including

  • Keyword hover
  • Eclipse context help
  • Feature Reference documentation part (feature-reference.md)

Online Help Site

Eclipse Help

HowTo Edit

To update/publish everything run make.xml. Logs can be found in folder /tmp.

FeatureModel

All artifacts are automatically generated to folder /feature-gen on change. make.xml copies them to the final location:

  • feature-reference.md to folder /online-doc/content
  • else to folder /targets

Online Help Site

The documentation content resides in folder /content (exception feature-reference.md is copied there). The output folder for the complete generated site is /online-doc/target. Run Ant script run_online-doc.xml to start Stagen.

Stagen

A static site generator, readme can be found in the repository. A modified version is used, that supports

  • xtext syntax highlighting
  • toc generation
  • markdown within tables (every table cell is generated isolated)

Eclipse Help

Basically derived from Online Help Site by the means of copying and generating, but with different layout.