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
Ihis entity auto-replaced with ../../../.. by default
and with http://www.FreeBSD.org/ when URLS_ABSOLUTE is set
(used for mirrors and for release building accordingly)
ports collection. One step is not yet defined; hopefully this will be
resolved soon.
PR: docs/64144
Reviewed by: eik and many others
Approved by: ceri (mentor)
- Remove the requirement for mentors to send PGP keys of new
committers to admins@.
committers-guide/article.sgml:
- Update copyright year.
- Emphasize that new committers should add their PGP key to the
Handbook, since it might be needed for identification, e.g. for
account recovery.
teams.ent:
- Add an entiry for admins@.
Discussed with: admins (joe, kensmith)
- Add trademark tags as needed, generally on first use in each
article.
- Add an attribution to the legal section mentioning all trademarks
referenced.
- Always use correct case for trademarks.
- Don't join trademarks with other words, e.g. using hyphens.
trademark.ent:
- Commonly used trademarks are defined as entities for ease of use.
- All trademark attributions are defined as entities for ease of use.
Approved by: ceri (mentor)
CVS operations, where it fits slightly better.
Note to translators: I have tried to be sensitive to whitespace here, but it
has proved to be quite difficult in both this and the last revision. Apologies
in advance.
In reality, it is pretty close to Tier-1, but there are still a few
loose ends that need to be taken care of before locking down ABIs etc.
It was actually included in 5.1-RELEASE and it now has pre-built ports
packages etc.
