- add newsgroups.ent
- add above item to catalog file, then use it in articles.ent and books.ent
Noticed by: kano at na dot rim dot or dot jp
Reference: [doc-jp 14506]
the charset of HTML files generated from an DocBook/SGML file.
Note to translators:
While some of the translations already use this tweak
in their localized freebsd.dsl, it is no longer needed so
removed and the necessary changes have been added instead.
After this commit, please make sure to define
&doc.html.charset; in <langcode>/share/sgml/l10n.ent.
If not defined, iso-8859-1 is used by default and it can
break the translation.
Discussed on: -doc
Currently we have articles.ent and books.ent, and
for example, articles.ent can be used by putting the
following lines in the doctype declaration:
<!ENTITY % articles.ent PUBLIC
"-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//EN">
%articles.ent;
This pulls all of the necessary entities via share/sgml/articles.ent.
The translation teams can customize these entities by redefining
the articles.ent file in <langcode>/share/sgml. See
ja_JP.eucJP/share/sgml for example.
in <ulink> like <ulink url="&url.books.handbook;/kernelconfig.html"></ulink>.
To use these entities, put the following lines in preamble (DOCTYPE
declaration) of the document:
<!ENTITY % l10n.ent PUBLIC "-//FreeBSD//ENTITIES DocBook Language Specific Entities//EN">
%l10n.ent;
<!ENTITY % urls.ent PUBLIC "-//FreeBSD//ENTITIES DocBook URL Entities//EN">
%urls.ent;
and put URL_RELPREFIX in the Makefile.
For translation teams:
please add your "langcode" into <langcode>/share/sgml/l10n.ent using
examples from en_US.ISO8859-1/share/sgml/l10n.ent and ja_JP.eucJP/share/
sgml/l10n.ent. &url.books.*; will be replaced with URLs for your
language; if you want URLs which point the original (English) docs,
you can use &url.books.*.en; instead.
Discussed with: den
- The structure of transtable.xml is revised. <word> should be
bracketed with <group>.
- A sorting order of the FreeBSD mirror sites rendered using
mirrors.xml has been determined by sort(1).
- A template "transtable-lookup" has been added for localization on
word-by-word basis.
- Replace English month names in news.xml, press.xml, and
advisories.xml with numbers that correspond to the names.
The number->name translation is performed on the fly.
- Since information in mirrors.xml is used in www/ tree, it depends on
doc/ tree now. When WITHOUT_DOC is defined it can be built without
doc/ tree, but some information becomes unavailable. For example,
a list of the mirror sites generated in index.html becomes a dummy
one, and calling "transtable-lookup" with a word returns the word
itself.
Neither www/ nor doc/ build should be broken due to this commit, but
until the necessary changes are applied in the localized directories,
the transtable does not work; it simply generates non-localized contents
even if transtable.xsl is used.
- add doc.common.mk, which defines variables, targets, and
dependencies commonly used in www/ and doc/.
- move www/<lang>/includes.xsl to the language independent
directory and split into several files.
- add transtable*.xsl and transtable.xml to support localized
mirror names.
- make doc/{en_US.ISO8859-1,ja_JP.eucJP}/books/handbook/ use
mirrors.xml (mirrors and eresources).
- make www/{en,ja}/index.xsl use mirrors.xml.
For details, please see doc/share/sgml/README.mirrors for the moment.
Reviewed by: simon and Alex Dupre <sysadmin@alexdupre.com>
enable it in en_US.ISO8859-1/ and ja_JP.eucJP/.
- Add PUBLIC "-//FreeBSD//ENTITIES DocBook Language Specific Entities//EN"
and l10n.ent for entity localization.
- Use share/misc/docbook.css for indentiation of <programlisting>
and <screen>.
- Add some missing $FreeBSD$.
share/sgml directories, create a public identifier for it and replace all
SYSTEM references to the file with PUBLIC references.
There was no repo-copy made of these files as there is no important
history to preserve.
