evergreen-docs:how-to-contribute-documentation
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
evergreen-docs:how-to-contribute-documentation [2021/07/08 14:15] – aneiman | evergreen-docs:how-to-contribute-documentation [2022/02/10 13:34] – external edit 127.0.0.1 | ||
---|---|---|---|
Line 5: | Line 5: | ||
We use [[http:// | We use [[http:// | ||
- | FIXME is the below statement still accurate? I know the PDF / HTML part is not, but curious about the rebuild timing. | + | **Note**: Changes to the official repository are processed into HTML daily at 1am. (see http:// |
- | + | ||
- | **Note**: Changes to the official repository are processed into HTML, PDF and ePub daily at 1pm and 11pm. (see http:// | + | |
==== Beginner workflow ==== | ==== Beginner workflow ==== | ||
Line 75: | Line 73: | ||
After you've made your changes, make sure that your documentation is included in the appropriate module(s). | After you've made your changes, make sure that your documentation is included in the appropriate module(s). | ||
- | |||
- | FIXME the test build instructions need to be updated for Antora. | ||
Then **test building the various output formats**. | Then **test building the various output formats**. | ||
Line 83: | Line 79: | ||
- '' | - '' | ||
- '' | - '' | ||
+ | |||
+ | === Build the Evergreen Documentation site locally === | ||
+ | |||
+ | **This allows you to " | ||
+ | |||
+ | * More details located in the Evergreen code repository: docs/ | ||
+ | * Be sure and have Node installed. see [[https:// | ||
+ | * Once Node is installed, follow the Antora prereqs. Summarized from [[https:// | ||
+ | * Now run generate_docs.pl | ||
+ | |||
+ | |||
+ | ^ | ||
+ | | base-url | URL where html output is expected to be available eg: http:// | ||
+ | | tmp-space | Writable path for staging the antora UI repo and build files, defaults to ./build | | ||
+ | | html-output | Path for the generated HTML files, defaults to ./output | | ||
+ | | antora-ui-repo | Antora-UI repository for the built UI | | ||
+ | | antora-version | Version of antora to use for build, defaults to 2.3 | | ||
+ | |||
+ | * Example: | ||
+ | < | ||
+ | $ cd Evergreen/ | ||
+ | $ ./ | ||
+ | --base-url http:// | ||
+ | --tmp-space ../../tmp \ | ||
+ | --html-output / | ||
+ | --antora-ui-repo git:// | ||
+ | --antora-version 2.3 | ||
+ | </ | ||
+ | |||
+ | * To view the site perfectly, you will need to have a web server running on your computer. | ||
+ | |||
+ | |||
When you are satisfied with your changes, commit the files. | When you are satisfied with your changes, commit the files. |
evergreen-docs/how-to-contribute-documentation.txt · Last modified: 2023/06/01 12:13 by gmcharlton