When I first saw the string –
HUGO_DISABLELANGUAGES=""
– in output from make run, I cancelled, then made a false assumption
about how to proceed with fewer languages.
Sharing my mistake, and subsequent success, for the benefit of others
who might (in future) make similar mistakes:
% pwd
/usr/home/grahamperrin/dev/freebsd/freebsd-doc/website
% make run
---------------------------------------------------------------
Building the website started on Sun 27 Aug 2023 12:45:46 BST
included languages: de el en es fr hu it ja nl ru tr zh-cn zh-tw
excluded languages:
---------------------------------------------------------------
HUGO_DISABLELANGUAGES="" /usr/local/bin/hugo server -D
--baseURL="http://localhost:1313";
WARN DEPRECATED: Kind "taxonomyterm" used in disableKinds is deprecated,
use "taxonomy" instead.
WARN Unknown kind "list" in outputs configuration.
WARN Unknown kind "single" in outputs configuration.
Watching for changes in
/usr/home/grahamperrin/dev/freebsd/freebsd-doc/website/{archetypes,content,data,static,themes}
^C*** Signal 2
% make HUGO_DISABLELANGUAGES="de el es fr hu it ja nl ru tr zh-cn zh-tw"
run
---------------------------------------------------------------
Building the website started on Sun 27 Aug 2023 12:45:57 BST
included languages: de el en es fr hu it ja nl ru tr zh-cn zh-tw
excluded languages:
---------------------------------------------------------------
HUGO_DISABLELANGUAGES="" /usr/local/bin/hugo server -D
--baseURL="http://localhost:1313";
WARN DEPRECATED: Kind "taxonomyterm" used in disableKinds is deprecated,
use "taxonomy" instead.
WARN Unknown kind "list" in outputs configuration.
WARN Unknown kind "single" in outputs configuration.
^C*** Signal 2
% make DOC_LANG="en" run
---------------------------------------------------------------
Building the website started on Sun 27 Aug 2023 12:46:32 BST
included languages: en
excluded languages: de el es fr hu it ja nl ru tr zh-cn zh-tw
---------------------------------------------------------------
HUGO_DISABLELANGUAGES=" de el es fr hu it ja nl ru tr zh-cn zh-tw"
/usr/local/bin/hugo server -D --baseURL="http://localhost:1313";
…
Reference:
<https://docs.freebsd.org/en/books/fdp-primer/book/#doc-build-rendering-html>
example 3 onwards;
<https://docs.freebsd.org/en/books/fdp-primer/doc-build/#doc-build-rendering-html>
example 2 onwards.
(The same set of examples, different numbers.)
