converted to DocBook 5.0. This results in an ugly markup at some parts
but this can be corrected after the conversion is done. Anyway, these
sections need serious rewriting.
- Fix a double application element
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.
properly with xsltproc and the latter is simpler
- Add a constraint to prevent using screenco, programlistingco and
graphicco in the future
- Note that mediaobjectco is used in the documentation to properly
compose a figure element but the callout bugs are already there
in the source image and not placed there by the stylesheets
newer libxslt which check the stylesheet syntax more strictly.
|It is an error for the value of either the use attribute or the match
|attribute to contain a VariableReference.
| (XSL Transformations (XSLT) Version 1.0, Section 12.2)
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)
much better ways of doing this in modern web browsers. Furthermore, it
never worked as well as it should have done, as too much of the website is
built around fixed layouts.
It was felt it was best to remove the size switcher from all languages at
once, so that the infrastructure (styleswitcher.js etc.) could be removed
at the same time.
Discussed at: Cambridge DevSummit, August 2012
Discussed on: www@
Approved by: gabor (mentor)
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)
- Allow disabling last modified date by setting the date variable to
empty text
- Only disable last modified date in old news, press, events pages since
it makes sense for recent entries
Approved by: doceng (implicit)
required setting up CVSROOT and the CVS repo is not the main repo anymore
(and we already use fetch(1) elsewhere)
- Clean up the corresponding parts in translations, use a single copy of
LEGAL from the English pages
Approved by: doceng (implicit)
(Note: old leftovers from commercial/ have been dropped since they are
extremely outdated and the generation process is very complicated.)
Approved by: doceng (implicit)
advocacy pages of the website.
- Remove letter.sgml itself in zh_CN.
- Remove references to letter.sgml from the advocacy directory's Makefile in
zh_CN.
Approved by: blackend, delphij, gabor (mentor)
- 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)
- Repocopy from www/<lang> to head/<lang>/htdocs to eliminate duplicate
information in the www and the doc directory.
- Add various administration files to svnadmin.
Approved by: doceng (implicit)
