Some consumers may be interested in building the whole enchilada. Add a top
level Makefile to make that feasible.
Both the documentation and website build can run in parallel, and one only
needs to run either the all or generate targets from the top level.
Reviewed-by: gjb, hrs
Differential-Revision: https://reviews.freebsd.org/D28385
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
Summary:
The doc repository is not mirrored to Subversion so updating the
repository from Subversion does not make sense. Remove
Subversion-specific files too.
While here remove now defunct $FreeBSD$ markers in affected files.
Test Plan:
make clean
make update
make
Reviewed by: bcr, ygy, doceng (gjb)
Differential Revision: https://reviews.freebsd.org/D27678
Subscribers: drewery, emaste
For no_NO.ISO8859-1:
The Last Changed Date of no_NO was on 2013-11-07 16:37:11 +0000 (Thu,
07 Nov 2013). Of all the file, only the handbook has any translations
of which there are only basics/chapter.xml, bibliography/chapter.xml,
and install/chapter.xml. The latter of which still documents
sysinstall. I also can't seem to find any reference to the files
here: https://download.freebsd.org/ftp/doc/.
For sr_YU.ISO8859-2: no content in-tree at all.
Discussed with: blackend
- Replace /XML/{doc,www}/ with /XML/ in SysId.
- Remove empty stylesheets in share/xsl and point share/xml/empty.xsl via
XML catalog instead.
- Change the L10N layer in freebsd-*.xsl not to use localized XSLT
stylesheets directly.
- Move share/xsl/* to share/xml and remove share/xsl.
- Remove obsolete share/web2c/pdftex.def.
- Move files under <lang>/htdocs/share to <lang>/share.
- s/WEB_PREFIX/DOC_PREFIX/
- Update the webupdate script to use the SVN repository.
Approved by: doceng (implicit)
Also fix several minor bugs here, such as leftover files not being
deleted after 'make clean'.
PR: docs/31131
Submitted by: Cyrille Lefevre <clefevre@citeweb.net>
in the case of */FAQ/Makefile, because the FAQs are all in the wrong
place. Things still install properly, but some of the directory paths
are hardcoded. This will be going away ASAP.
