mirror of https://git.FreeBSD.org/doc.git
284030c301
When we build our documentation and website we use a hacked version of www/gohugo that allows for arbitrary asciidoc extensions. This was added as a patch in r562416. The suggested pull request[1] this patch was based on was not accepted "as is" and only allows the execution of extensions in Ruby's $LOAD_PATH. With these changes, we add our <docroot>shared/lib directory to Ruby's library directory so we can load our custom extensions. This also allows building the docs and website outsite FreeBSD using upstream and unmodified tools. Tested with the upcoming vanilla gohugo-0.82 provided by gohugo's maintainer. [1] https://github.com/gohugoio/hugo/pull/8131 Patch by: fernape@ Differential Revision: https://reviews.freebsd.org/D29410 |
||
|---|---|---|
| .. | ||
| archetypes | ||
| config/_default | ||
| content | ||
| data | ||
| static | ||
| themes/beastie | ||
| tools | ||
| .editorconfig | ||
| .gitignore | ||
| Makefile | ||
| README | ||
| beastie.png | ||
| shared | ||
README
$FreeBSD$
If you plan on building a local copy of the FreeBSD documentation, or using
our toolchain in your own projects, please read the Documentation Primer at:
https://www.FreeBSD.org/doc/en/books/fdp-primer/
for information about the tools and formatting languages we use.
Chapter 1 has a Quick Start section, and Chapter 2 covers the software
and related items in more detail.