os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
51660 commits 1 branch 79 tags 298 MiB
Commit graph

395 commits

Author SHA1 Message Date
Warren Block
0a4ab32374 Make the normalized translation file depend on all the SRCS of the 
English original document.

Reviewed by:	rene
 2015-10-28 00:53:13 +00:00
Warren Block
832689be3b Use the en_US xmllint catalog variables so translated entities do not 
make their way into PO translations.

Reviewed by:	rene
 2015-10-16 22:30:02 +00:00
Warren Block
f78699024c Remove a duplicated {PO_LANG}.mo from CLEANFILES. 
Modify the PO_SET script to add a #$FreeBSD$ line to new PO files.
 2015-10-13 21:45:26 +00:00
Warren Block
faabf968e9 Add PO translation support. 
Reviewed by:	hrs (earlier version), blackend
Approved by:	doceng (implicit)
Differential Revision:	https://reviews.freebsd.org/D2947
 2015-08-24 15:54:10 +00:00
Warren Block
dfe61c9435 Allow installing website as an unprivileged user. 
Reviewed by:	hrs
Approved by:	doceng (implicit)
 2015-07-23 02:51:10 +00:00
Warren Block
de3c946bda Set FOP_OPTS, the variable passed by the fop shell script to the Java 
interpreter, to use the same minimum values for stack and heap space on
all architectures.  The built-in i386 defaults are smaller than those on
amd64, so i386 fop PDF builds ran out of space and failed.  Working
values were copied from the amd64 defaults.

Reviewed by:	gabor, blackend, hrs
Approved by:	hrs
 2015-07-17 05:30:04 +00:00
Warren Block
bec94907eb Increase the global size of maxvars for xsltproc to help it choke down 
large indigestible blobs like the PGP keys article.  Also remove the
special settings in the PGP Keys article Makefile that are no longer
necessary.
 2015-06-30 14:47:21 +00:00
Benedict Reuschling
e387536540 Remove instance of nonexistent catalog-common.xml from the doc toolchain. 
There is no reference in any other file and a full doc build does not fail
when it is missing.

Differential Revision:	https://reviews.freebsd.org/D2880
Reviewed by:	wblock, hrs
Approved by:	hrs (doceng)
 2015-06-24 18:18:52 +00:00
Bjoern A. Zeeb
f05cca897d Bump copyright year. 
Happy New Year 2015!
 2014-12-31 10:00:44 +00:00
Gabor Kovesdan
bc0ea04e7d - Move the PGP keyring generation to the language-independent share directory 
Discussed with:	hrs, wblock
 2014-03-07 12:23:51 +00:00
Hiroki Sato
826bb636a9 Add authors.ent as a dependency for wwwstd. 2014-02-07 05:23:55 +00:00
Glen Barber
c5b864fbfc Bump copyright year. 
Happy New Year 2014!

Sponsored by:	The FreeBSD Foundation
 2013-12-31 12:33:29 +00:00
Hiroki Sato
5e44b57891 Use URI to specify xhtml.xsl. 2013-11-14 21:39:04 +00:00
Hiroki Sato
b436d0a16d - Enable docformatnav only when $docformatnav is set to 1. 
- Set $docformatnav to 1 when $FORMATS contains "html" and "html-split" at the
  same time.
- Fix localization of docformatnav using &docnavi.{split,single};.
- Do not create <a> element which points to the document itself.
- Remove share/xml/l10n.ent.
- Fix URI of freebsd-fo-cjk.xsl.
 2013-11-13 07:07:52 +00:00
Hiroki Sato
52f6d56540 - Use /usr/bin/svnlite as SVN if available. 
- 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.
 2013-11-13 06:10:37 +00:00
Hiroki Sato
ae0395da63 Simplify localization layer for XSLT stylesheets. lang/share/xsl/*.xsl are 
now picked up via share/xsl/*.xsl and they are empty when there is no
localized content in it.  This prevents inconsistency between share/xsl/*.xsl
and the localized ones.
 2013-11-11 19:26:20 +00:00
Hiroki Sato
6db049ce33 Use XML catalog resolution wherever possible instead of absolute pathnames 
for external entities.
 2013-11-11 18:12:26 +00:00
Hiroki Sato
982ae5a81b Revert an unintended change in the previous commit. 2013-11-11 06:54:40 +00:00
Hiroki Sato
db0b08db8f - Define l10n.ent as an entity in localized directories and make them be 
picked up via XML catalog in freebsd50.ent or xhtml10-freebsd.dtd,
  not entities.ent.  The L10N entities always come first to be able to
  override everything.

- Define &nbsp; as &#x20; in EUC-JP encoding.  This is a workaround to
  prevent an invalid character in EUC-JP caused by converting 0xa0 in
  UTF-8 (EUC-JP does not allow 0xa0) in XSLT processing.  Theoretically
  it should be &#xa0; still in the final XML output.

- Make XML catalog resolution consistent for l10n.ent.  This should be
  revisited for the others later.
 2013-11-11 06:52:59 +00:00
Gabor Kovesdan
181f228a2f - Fix build of release notes 
Approved by:	doceng (self)
 2013-11-07 18:20:08 +00:00
Gabor Kovesdan
c7e8c2a60b - Really fix profiling 2013-11-07 12:48:24 +00:00
Gabor Kovesdan
561270fafd - Default PDF renderer will be FOP 2013-11-07 12:44:37 +00:00
Gabor Kovesdan
61e970ba9d - Fix profiling support 2013-11-07 12:44:11 +00:00
Gabor Kovesdan
7d632b6bcf - Improve generated epub file 
* Generate EPUB3
  * Wrap programlistings if necessary
  * Use grey background and smaller fonts for programlistings
  * Justify main text
  * Do not break after table caption
 2013-08-14 22:29:07 +00:00
Gabor Kovesdan
69b5fa65aa - Remove index-related bits; indexes are now enabled by default 2013-07-25 20:56:29 +00:00
Gabor Kovesdan
988c5ce88c - MFH 2013-07-24 19:11:16 +00:00
Gabor Kovesdan
5b6ecc816f - Add dblatex customization for Japanese 2013-07-21 14:50:28 +00:00
Hiroki Sato
8b0e071062 Revert w3m in HTML2TXT to links. This is a temporary measure for 
build breakage on non-x86 platforms.
 2013-07-21 14:47:14 +00:00
Gabor Kovesdan
7d8720ec06 - Use the xetex backend since it works better for Unicode 2013-07-21 14:14:43 +00:00
Gabor Kovesdan
a751e1e60f - verbatim hyphenation requires higher recursion depth 2013-07-21 14:05:38 +00:00
Gabor Kovesdan
9ab14a1f7c - Make sure images and callouts are found 2013-07-13 07:02:57 +00:00
Gabor Kovesdan
480e4220cf - Add a FOP config file and use it 2013-07-11 19:27:42 +00:00
Gabor Kovesdan
8893e5621d - Workaround for dblatex escaping in <filename> 2013-07-10 10:38:06 +00:00
Gabor Kovesdan
2de4169711 - Add experimental support for dblatex 2013-07-03 15:22:19 +00:00
Gabor Kovesdan
a4722b0475 - Add support for RELAX NG validation since it is the normative DB 5.0 
schema.  The DTD validation still does a good job so there is no need
  to install Java; RNG validation is optional
 2013-07-03 12:07:50 +00:00
Gabor Kovesdan
fc03eb5c00 - MFH 2013-07-03 10:43:17 +00:00
Gabor Kovesdan
b422bc43c3 - Drop DTD after parsing 2013-06-30 09:22:48 +00:00
Marc Fonvieille
e0c4e936e0 Fix install-html-split target: 
With the current code running "make install" will build the files but
will install only 2 files (docbook.css and tramemark.html).  Another
"make install" is required to get the missing files.  This is not the
expected behavior.  A quick workaround is to run "make && make
install", but let's fix the code to get a working "make install".

Discussed with:	gabor
 2013-06-24 08:23:29 +00:00
Gabor Kovesdan
2d59309da5 - Use the :T modifier instead of :C 
Submitted by:	hrs
 2013-06-21 17:57:26 +00:00
Gabor Kovesdan
194644ff8a - Create the Schematron XSLT in the current directory 
- Properly clean up after validation
 2013-06-21 11:38:45 +00:00
Gabor Kovesdan
97ece4326c - Port some of the customizations to DocBook 5.0 
- Add namespace declaration to DocBook elements in entities since DocBook 5.0
  uses a namespace
- Drop Jade-specific compatibility nits
 2013-05-30 20:09:44 +00:00
Gabor Kovesdan
a7b70eb4e8 - Use namespace-aware stylesheets 
- Drop more legacy stuff
 2013-05-29 19:29:43 +00:00
Gabor Kovesdan
cfb01a3c46 - Remove Jade-related code 2013-05-29 19:26:44 +00:00
Gabor Kovesdan
c94df498ed - Drop SGML catalogs 
- Drop DSSSL stylesheets
- Drop some DSSSL-related comments and Makefile code
 2013-05-29 19:21:25 +00:00
Gabor Kovesdan
f2976a4c6d - Port PGP keyring generation to XSLT 2013-05-23 06:12:40 +00:00
Gabor Kovesdan
f207ef1393 - LANGCODE used to resolve to "." when called from the top-level directory; 
failing this resulted in bogus file removals so revert this behavior
 2013-05-17 19:56:43 +00:00
Gabor Kovesdan
73674733ad - Properly support EXTRA_CATALOGS (they are now XML catalogs) 2013-05-15 13:40:51 +00:00
Gabor Kovesdan
518b16d8e7 - The old LANGCODE detection was bogus and did not work properly with 
release notes. Use a different approach that works.
 2013-05-15 13:40:06 +00:00
Gabor Kovesdan
fd27f6900b - Use absolute URLs in printed formats 2013-05-07 14:33:38 +00:00
Gabor Kovesdan
03a4531673 - Work around overflowing images 2013-05-07 10:02:48 +00:00
Gabor Kovesdan
ffd8fc666f - Allow foreign elements in Schematron 
- Add some embedded XSLT to improve the input of validation failures
 2013-04-03 10:56:14 +00:00
Gabor Kovesdan
d5c6e245d4 - Remove some further unused leftovers 
- Make sure printed docs generated with DSSSL always use .eps images
- And XSLT-based output always uses .png
- Fix image conversion
 2013-04-01 08:16:09 +00:00
Gabor Kovesdan
68eb6e1a6c - Remove more leftovers 
- Simplify image processing so that html always uses .png and printed
  formats always use .eps
 2013-03-31 21:35:32 +00:00
Gabor Kovesdan
c8eadc3369 Always build pdf from ps and remove related nits. This is what was already 
done with Handbook and building pdf directly does not seem to work
correctly anyway. This change will help simplifying the build process
and spare some image conversions.
 2013-03-31 21:11:07 +00:00
Gabor Kovesdan
996eb9dce9 - Add support for profiling 2013-03-15 10:26:27 +00:00
Gabor Kovesdan
c1ddd50c4c - Suppress the XML declaration emitted by the Schematron XSLT 2013-03-15 08:40:03 +00:00
Gabor Kovesdan
96d2077fac - Make the validate/lint target fail when Schematron validation gives output. 
This is useful when running lint from upper directories. Otherwise,
  a validation error would not cause make to halt and an error could
  remain unspotted.
 2013-03-15 07:49:33 +00:00
Gabor Kovesdan
44368e5859 - Add support for Schematron validation 
- Add a simple Schematron file that validates file references
- Silence the output of validation so that the result be more readable
 2013-03-14 10:25:23 +00:00
Gabor Kovesdan
d55a546a05 - Work around a DocBook XSL bug which lists unexisting files in the 
manifest
 2013-02-25 20:19:29 +00:00
Gabor Kovesdan
0701bf45bd - Add infrastructure for language-specific XSLT customizations 2013-02-25 20:17:26 +00:00
Gabor Kovesdan
59d4db9584 - Add back SGML catalogs (trimmed to minimally necessary content) since 
they are still needed for language-specific DSSSL customizations
 2013-02-19 16:14:00 +00:00
Gabor Kovesdan
28d065247c - Fix rendering of Handbook with (Open)Jade 2013-02-18 13:03:19 +00:00
Gabor Kovesdan
f1a9c7762c - Revert r40891 since the created archive has compatibility problems 2013-02-05 10:11:29 +00:00
Gabor Kovesdan
5ab0b5a928 - Also add images to the epub archive 2013-02-05 10:02:36 +00:00
Gabor Kovesdan
f91ca3af36 - Use bsdtar to create zip archives 
Submitted by:	hrs
 2013-02-05 09:39:04 +00:00
Gabor Kovesdan
a06603e1e8 - MFH 2013-02-05 09:14:34 +00:00
Gabor Kovesdan
5be9852003 - Better categorize and sort 2013-02-04 09:41:53 +00:00
Gabor Kovesdan
49010f9fab - Do not pass unused XSLT params 
- Remove some conditionals since we always use XML catalogs
 2013-02-04 09:05:59 +00:00
Gabor Kovesdan
f8e80d75f9 - Include command macros 
- Drop some obsolete SGML constructs
 2013-02-03 21:28:23 +00:00
Gabor Kovesdan
2f0c94a684 - Do not pass the --catalogs option to xmllint/xsltproc since we don't 
have SGML catalogs any more
 2013-02-03 21:11:22 +00:00
Gabor Kovesdan
4cb9e266b6 - Remove doc.html.mk, which is not used any more 
- Factor out command macros for better readability and consistency
  and less duplication
- Make some macros more consistent with the rest
 2013-02-02 14:52:15 +00:00
Gabor Kovesdan
7919bb16d6 - Remove some rarely used and badly supported features 2013-02-01 19:51:58 +00:00
Gabor Kovesdan
3a1f4b3005 - Build index in the DocBook XSL way 2013-02-01 19:50:33 +00:00
Gabor Kovesdan
3327cf64d4 - Remove HTML Tidy leftovers 2013-02-01 18:51:52 +00:00
Gabor Kovesdan
90daffe2e7 - Remove some SGML leftovers 2013-02-01 18:45:41 +00:00
Gabor Kovesdan
3a2d8092b9 - Clean up leftovers after make lint 2013-02-01 17:37:53 +00:00
Gabor Kovesdan
e1fa809a80 - There is no need for XInclude processing at the point when xsltproc is 
called
 2013-02-01 13:21:13 +00:00
Gabor Kovesdan
5a8e3a368d - Properly validate and process XInclude 2013-02-01 13:03:24 +00:00
Gabor Kovesdan
33e89a267c - Always parse the documentation first and use the parsed XML 
- s/PDFENGINE/RENDERENGINE/ and add support for generating .rtf with FOP
 2013-02-01 11:04:50 +00:00
Gabor Kovesdan
a3c89a1805 - Use exclusively the XML catalogs and drop the old SGML format 2013-02-01 09:48:25 +00:00
Gabor Kovesdan
9162098876 - Parse the documents with XML tools before passing them to Jade and turn off 
Jade validation.  This will let us keep using Jade for printed output
  rendering and dropping old SGML constructs at the same time.
 2013-02-01 09:18:30 +00:00
Gabor Kovesdan
249ab2480a - Add experimental support for FOP-based PDF and PS rendering 2013-01-31 10:27:59 +00:00
Gabor Kovesdan
2a1cbc680d - Add epub to KNOWN_FORMATS 2013-01-31 10:15:46 +00:00
Gabor Kovesdan
d891a25dc5 - Make sure all source files are ready before validation 
- Make sure all source files are ready before building
- Clean up the workarounds from handbook Makefiles
 2013-01-31 09:55:07 +00:00
Gabor Kovesdan
3a9b83582b - Use XInclude to include text files instead of <inlinegraphic> since such 
inclusion is not supported in standard XSLT and xsltproc provides no
  extensions for that
 2013-01-30 20:11:31 +00:00
Gabor Kovesdan
ebeaccc19d - Add support for epub generation 2013-01-30 16:36:59 +00:00
Gabor Kovesdan
651943c7e4 - Generate html and html-split with XSLT rather than DSSSL 
- Good bye HTML Tidy
 2013-01-30 16:19:08 +00:00
Gabor Kovesdan
a1c12382a0 - Restore support for make lint 
- Validation is now actually XML validation
 2013-01-21 17:31:17 +00:00
Hiroki Sato
4654052202 Fix a typo in the dependency detection. It ignored all of *.ent files 
accidentally.
 2012-11-03 21:16:08 +00:00
Isabell Long
2be1e25fc2 Replace 'SGML' with 'XML' in Makefile code and comments. A consequence of 
this was that 'SGMLFLAGS' had to be changed to 'XMLFLAGS' in
share/mk/doc.docbook.mk so that everything continued to build OK.

Approved by:	gabor (mentor)
 2012-10-06 17:52:37 +00:00
Gabor Kovesdan
77d737ee88 - Rename the share/sgml directories to share/xml 
- Fix build errors from the next change

Approved by:	doceng (implicit)
 2012-10-01 11:56:00 +00:00
Gabor Kovesdan
b4346b9b2d - Rename .sgml files to .xml 
- Reflect the rename in referencing files

Approved by:	doceng (implicit)
 2012-10-01 09:53:01 +00:00
Bjoern A. Zeeb
8a1a59e2f5 Hook-up advistories and patches to be installed to 
www.freebsd.org/security/{advisories,patches}/...
from the en_US.ISO8859-1 directory as we do for logos, etc.

The magic is a bit special to avoid having to add each advisory
or errata notice, and their patches and signatures individually.

Factor out the slightly different to bsd.links.mk SYMLINKS
support as well as the "bulk data install" that cannot be
handled by just DATA as (i) the input dir differs, (ii) input
uses a 1 or more level of sub-directories.

This is the second of three steps.  The last one will be to link
to these files locally rather than to security.freebsd.org.

Approved by:	gabor
 2012-09-17 08:42:56 +00:00
Gabor Kovesdan
3d401ef124 - The trademarks.html file is now generated with a lower-case filename, 
reflact that

Submitted by:	ebrandi (via private mail)
 2012-09-16 18:26:39 +00:00
Hiroki Sato
82e24f3e86 Suppress HTML Tidy's version string output. 2012-09-14 15:35:18 +00:00
Gabor Kovesdan
bfb29d953f MFH 
Approved by:	doceng (implicit)
 2012-09-14 09:21:39 +00:00
Glen Barber
1456891f7e Change WEBGRP and CGIGRP defaults. 
The web build uses WEBGRP and CGIGRP to determine group ownership
during the build phase.  When left unset, the default group is 'www'.
The problem is that if $USER is not in group 'www', the build will
fail due to lack of permissions via chgrp(1).

This change sets default values for WEBGRP and CGIGRP to $USER, unless
explicitly set during build time to prevent chgrp(1)-invoked build
failure.

Note:  This change has no effect for users currently setting WEBGRP
and CGIGRP, either via command-line or within scripts.

Reviewed by:	-www@ (silence)
 2012-09-10 10:47:53 +00:00
Gabor Kovesdan
6b67dd8ee6 - The latest version of tidy broke compatibility and expects different 
command-line options. It seems that this is the correct fix for the
  earlier problems.

Approved by:	doceng (implicit)
 2012-09-03 19:47:51 +00:00
Gabor Kovesdan
1e95d140ac - Add missing closing } 
Approved by:	doceng (implicit)
 2012-08-30 19:48:29 +00:00
Gabor Kovesdan
38f7e27108 - Fix generation of enbase 
Approved by:	doceng (implicit)
 2012-08-30 16:51:53 +00:00