Currently '/usr/local/bin/python3.7' is used as the value of
PYTHON_CMD. Right now this works because 3.7 is the default version of
Python 3 in the ports tree. However, at some point in the future, this
will be undoubtedly be changed.
It is also possible that users already might be building versions
newer than the default port/package, which needs to be an supported as
well.
In addition, the FDP recommends installing the 'python3' package. This
meta port/package depends on the default version of python, and
automatically creates a symlink to the default version.
With all this in mind, use '/usr/local/bin/python3' is used as the value
of PYTHON_CMD, since this means that the instructions will work
irrespective of which version is assigned.
In order for hugo to build all links correctly, it is necessary to
define baseURL - but in order to do this, we need some way of adding a
hostname. This change adds the HOSTNAME variable to accomplish this.
Another advantage is that if HOSTNAME is set to something other than
localhost, hugo can be run on a different (more powerful) machine which
can shorten the time it takes to build.
A note about this will need to be added to the FDP later.
This ensures that `make all` will never try to run the internal server.
Instead, the user can run it manually if they need to.
Reviewed-by: gjb, hrs
Differential-Revision: https://reviews.freebsd.org/D28384
This instructs make(1) to consider them always out of date, and prevents
foot-shooting if a directory entry with the same name comes into existence.
Reviewed-by: gjb, hrs
Differential-Revision: https://reviews.freebsd.org/D28383
This ensures that the build still generally works if one specifies jobs and
multiple targets at the same time.
Reviewed-by: gjb, hrs
Differential-Revision: https://reviews.freebsd.org/D28382
The build should strive to not write to the shared space, so symlink these
back to the one copy and remove the prep work needed.
Reviewed-by: gjb, hrs
Differential-Revision: https://reviews.freebsd.org/D28381
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
