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.
is not defined.
- URL_RELPREFIX must always point the top page's URL
(http://www.FreeBSD.org) in relative form, defined in Makefile.
- &url.base; can be used in doc/<langcode>/*. It will be
replaced with the real URL which points the top page.
For translators: Please make sure to define URL_RELPREFIX to
point the top page. The localized docs have different directory
hierarchy in its URL from the English version.
Tested by: den
I intend this article to be the first thing that new FreeBSD users
encounter when looking for information about mailing lists (i.e. I intend
to replace most links in our existing web pages to the 'How to get the
best results from freebsd-questions' article to this one instead; and
to have that article referenced from this one). That will happen shortly
(not yet).
Much of the text is indeed recycled from that article (thanks to Grog
for permission to do so), but some, including the bikeshed meta-info,
is my own. I have also generalized his article to apply to any mailing
list (not just FreeBSD-specific, although there is new text that touches
on that as well).
I have no doubt that there are rough edges in this article (both
stylistically and formatting). Please let me know. NB: it has
been tested locally with a make in the articles/ directory.
PR: docs/64934
Discussed with: ceri, grog, a few others.
