reasonable to maintain the reference, use the archived docs.
5-roadmap
checkpoint
dialup-firewall
diskless-x
euro
formatting-media
hats (content moved to htdocs/internal)
multi-os
storage-devices
vinum
zip-drive
All of these articles can be found here:
http://docs.freebsd.org/doc/9.0-RELEASE/usr/share/doc/freebsd/en_US.ISO8859-1/articles/
No objection from: doc@, www@
- Documentation is updated from DocBook 4.1/SGML to DocBook 4.2/XML
- Webpages are updated from HTML 4.01 Transitional to XHTML 1.0 Transitional
- Static webpages are now processed by XSLT behind the scenes
- Webpages are now built with less cycles; tidy has been removed and the
date processing is now done by XSLT
- Generated webpages are now actually valid (they did not use to be)
- All XSLT stylesheets now pull in a main XSLT, which reduces
duplicated markup
- Site map and index are converted to an XML format with an
XSLT transformation that generates the output
- For docs, there is now only one entity set for both articles and books
- Some trademark/legalnotice entities have been merged to a cohesive
single entity file
- Untranslated entity sets are now always pulled in from the English tree
instead of redundant copies
- The base and enbase entities are already automatically generated so
remove inline definitions from individual files
- Fetch the LEGAL file via http instead of depending on CVS
- Convert id names to lowercase to avoid mixing different styles and
for better readability
- All PSGML comments are removed since they are mostly useless
- Convert character entities to normal characters
- Do not copy CSS files but override only necessary part
- Fix build with newest tidy
- Partly update the fdp-primer to reflect changes
Approved by: doceng (implicit)
- 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)
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
and the localized sysids to <langcode>/share/sgml/catalog.
Since <langcode>/share/sgml/freebsd.dsl still include some
language-neutral parameters and procedures for printable formats,
I will work on assorting them similarly. I am sorry that
this (and probably the next) commit may break the translation
team's usual update procedure, but you can merge the language-specific
freebsd.dsl from the English version as before.
Discussed on: -doc
to process generated HTML. This not cause any side effects except
leaving some character entities in their numeric form instead
converting them into alphabetical notation (< instead of <),
but since all browsers understand such cases it is not a problem.
This commit should make all translations tidy clean, since
tidy should not arise entities conversion problem as it did
for long time before. Therefore all occurences of manual settings
of TIDYFLAGS and NO_TIDY declarations for translations are removed.
No objections from: -doc
Requested by: Russian and Japanese translation teams
article, about diskless X servers. Will be turned in on in the main build
later this week, when a new release of the DSSSL stylesheets will include a
Serbian translation, also prepared by the submitted.
Submitted by: Vladimir Vrzic <random@beotel.yu>