From Hugo doc:
> With v0.109.0 and earlier the basename of the site configuration file was
config instead of hugo. You can use either, but should transition to the new
naming convention when practical.
Therefore `config.toml` is moved to `hugo.toml`.
> The taxonomyTerm page kind was effectively aliased to the taxonomy page kind
in v0.73.0 (https://github.com/bep/hugo/commit/114d4012a89ca88583de5979a6ec4a4799c739b7)
`list` and `single` are unknown configurations. Remove them.
Differential Revision: https://reviews.freebsd.org/D43406
Some developers and contributors have reported experiencing timeouts
when using cloud VMs with low resources. Configure the same timeout as
that used for offline builds.
I still hit the timeout when building misc/freebsd-doc-* ports in
parallel on poudriere.
And occasionally we are receiving package-fallouts because of this.
Right now every heading except the main one will display an
anchor when the cursor is over the heading.
In this way parts of the documentation can be easily shared
only clicking in the anchor.
In all pages except the main page for documentation portal
and website will be shown information about who made the last
modification and when.
Thanks to dbaio@ and lwhsu@ to work into the CI infrastructure
to reactivate the git info :)
As this is a new language in the FreeBSD documentation, other
files/translations were added together.
Reviewed by: dbaio (translating it back to English)
Approved by: dbaio (doceng)
Differential Revision: https://reviews.freebsd.org/D34599
Co-authored-by: Danilo G. Baio <dbaio@FreeBSD.org>
Remove Google Analytics from the Website and from the
Documentation Portal.
Also upgrade the FreeBSD's privacy policy page to reflect the
Google Analytics removal.
In the near future it will be replace with an open source alternative
Approved by: core@, webmaster@
Hugo added a security policy in 0.91 version to restric access to
os/exec, remote communication and similar as can be readed here[1]
* Allow the use of AsciiDoctor to 'exec'
* Add 'LOAD_PATH' and 'RUBYLIB' to 'osEnv' variables to allow the
use of custom AsciiDoctor extensions
Reported by: Li-Wen Hsu
[1] https://gohugo.io/about/security-model/
* Allow to build the documentation offline using Hugo
* Fix link problems
* Remove SVN entities
* Fix lang problems to help weblate
* Move all the AsciiDoctor translations to the shared folder to
help weblate
* Allow the possibility to build each document. For example each
document can be edited in and watched the result in real time in
VS Code or Vim/NeoVim.
Breaking changes:
Eliminate the possibility of building books or articles.
They must be builded at the same time.
This functionality will be restored when version 0.89.0 is in the
repositories in a couple of weeks.
Reviewed by: dbaio@
Differential Revision: https://reviews.freebsd.org/D31926
Changes:
- Add the description meta tag in the index, articles and books
- Add a brief description in each article and book.
- Remove the SVN expansion tag
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
With this extension a git hash can be easily referenced.
The porters handbook versions chapter uses this extension
as an example in the FreeBSD 14.0 version table.
An example of use
gitref:hash[repository="src|doc|ports",length=hash-longitude]
The repository should be src, doc or ports.
And if no length it's specified the macro will use 12 characters
of the specified hash.
PR: 253050
Submitted by: jhb@
I'm very pleased to announce the release of
our new website and documentation using
the new toolchain with Hugo and AsciiDoctor.
To get more information about the new toolchain
please read the FreeBSD Documentation Project Primer[1],
Hugo docs[2] and AsciiDoctor docs[3].
Acknowledgment:
Benedict Reuschling <bcr@>
Glen Barber <gjb@>
Hiroki Sato <hrs@>
Li-Wen Hsu <lwhsu@>
Sean Chittenden <seanc@>
The FreeBSD Foundation
[1] https://docs.FreeBSD.org/en/books/fdp-primer/
[2] https://gohugo.io/documentation/
[3] https://docs.asciidoctor.org/home/
Approved by: doceng, core
Vladlen Popolitov