os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
41974 commits 1 branch 79 tags 298 MiB
Commit graph

226 commits

Author SHA1 Message Date
Gabor Kovesdan
71c8436054 - Whitespace adjustments after last commit 2013-07-11 17:11:21 +00:00
Gabor Kovesdan
b0b78fa4e9 - Indexterms should not be embedded directly into a question or answer 
element but into a deeper paragraph, optimally right after the
  referenced word without spaces even [1] but somehow the schema allows
  badly nested indexterms.  Correct such entires in the whole documentation
  set.
- Add constraints to check for invalid indexterm entries.

See also: http://www.sagehill.net/docbookxsl/GenerateIndex.html#Indexterms [1]
 2013-07-11 16:34:54 +00:00
Gabor Kovesdan
e819151e45 - Fix the cases when the specified column number does not match the real one 
- Add a constraint for this
 2013-07-03 17:35:46 +00:00
Gabor Kovesdan
a6684b4306 - Reduce the misuse of role attribute; role="directory" should actually be 
class="directory"
- Add constraint to enforce this
 2013-04-04 11:40:58 +00:00
Gabor Kovesdan
e8e2dfdbab - Do not specify image file extensions in documents; the proper extension 
is appended during rendering
- For the same reason, do not specify format either
- Add constraints to enforce this
 2013-04-02 09:50:10 +00:00
Gabor Kovesdan
c8eadc3369 Always build pdf from ps and remove related nits. This is what was already 
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.
 2013-03-31 21:11:07 +00:00
Gabor Kovesdan
a1f0eaf271 - Place the footer below the navigation as it used to be 2013-03-15 08:06:33 +00:00
Gabor Kovesdan
f6c79f1bc8 - Change screenco to screen + co since the former is not supported 
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
 2013-03-14 20:51:01 +00:00
Gabor Kovesdan
eb47c46865 - Fix erroneous fileref's that result in missing images 
- Also fix fdp-primer examples
 2013-03-14 09:19:23 +00:00
Gabor Kovesdan
998b28cb3e - Add more customization layers 
- Localize footers
 2013-02-26 09:43:12 +00:00
Gabor Kovesdan
0701bf45bd - Add infrastructure for language-specific XSLT customizations 2013-02-25 20:17:26 +00:00
Gabor Kovesdan
06f710c8aa - Remove more DSSSL leftovers 2013-02-25 20:04:29 +00:00
Gabor Kovesdan
f5b13d3d30 - Clean up more DSSSL leftovers 2013-02-19 17:08:14 +00:00
Gabor Kovesdan
9f052111c6 - Remove a couple of DSSSL leftovers 2013-02-19 16:20:38 +00:00
Gabor Kovesdan
59d4db9584 - Add back SGML catalogs (trimmed to minimally necessary content) since 
they are still needed for language-specific DSSSL customizations
 2013-02-19 16:14:00 +00:00
Gabor Kovesdan
8c3f9c475f - Detach zh_TW FAQ from the build since it has an invalid Big5 character 
sequence and does not build
 2013-02-05 17:24:39 +00:00
Gabor Kovesdan
a06603e1e8 - MFH 2013-02-05 09:14:34 +00:00
Gabor Kovesdan
3327cf64d4 - Remove HTML Tidy leftovers 2013-02-01 18:51:52 +00:00
Gabor Kovesdan
a3c89a1805 - Use exclusively the XML catalogs and drop the old SGML format 2013-02-01 09:48:25 +00:00
Gabor Kovesdan
af7381742b - Move language-independent entities directly to the DTD 2013-02-01 09:03:01 +00:00
Gabor Kovesdan
d891a25dc5 - Make sure all source files are ready before validation 
- Make sure all source files are ready before building
- Clean up the workarounds from handbook Makefiles
 2013-01-31 09:55:07 +00:00
Gabor Kovesdan
5df509eaa2 - Remove standalone="no" statements from XML declarations since it did not 
always work and is no use anyway
 2013-01-30 19:12:36 +00:00
Gabor Kovesdan
36cdb51546 - Migrate the documentation set to DocBook 4.5 2013-01-30 14:00:53 +00:00
Gabor Kovesdan
a6016aaef9 - Make the Traditional Chinese documentation valid XML 2013-01-21 17:45:18 +00:00
Gabor Kovesdan
5086b7db96 - Fix the make lint (validate) target 2012-10-13 18:32:14 +00:00
Isabell Long
2be1e25fc2 Replace 'SGML' with 'XML' in Makefile code and comments. A consequence of 
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)
 2012-10-06 17:52:37 +00:00
Gabor Kovesdan
77d737ee88 - Rename the share/sgml directories to share/xml 
- Fix build errors from the next change

Approved by:	doceng (implicit)
 2012-10-01 11:56:00 +00:00
Gabor Kovesdan
b4346b9b2d - Rename .sgml files to .xml 
- Reflect the rename in referencing files

Approved by:	doceng (implicit)
 2012-10-01 09:53:01 +00:00
Isabell Long
bee5d224fe Remove the ability to change the font size on the website. There are now 
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)
 2012-09-30 13:27:05 +00:00
Gabor Kovesdan
dac93925ee - Remove stale chapter 2012-09-27 17:36:37 +00:00
Gabor Kovesdan
efe7023c1f - Encoding names should be IANA names and in lower case 2012-09-22 20:09:08 +00:00
Gabor Kovesdan
9b85c2d7f5 - Remove old web content and references to them 
Discussed with:	doc@, www@
 2012-09-22 19:20:16 +00:00
Gabor Kovesdan
d8a2cdf09b - Remove the following articles and references to them. Where it is 
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@
 2012-09-20 14:33:30 +00:00
Gabor Kovesdan
b0de170035 - Fix translated entities by Properly overriding l10n.ent in the catalog chain 
Approved by:	doceng (implicit)
 2012-08-30 17:41:56 +00:00
Gabor Kovesdan
099677a42e - Make CSS files pull in the major part from the original 
CSS files annd only override the necessary part.  This facilitates
  maintainability.

Approved by:	doceng (implicit)
 2012-08-27 08:05:18 +00:00
Gabor Kovesdan
862c85b832 - Fix conditional parts that depend on whether we currently have beta 
release(s)

Approved by:	doceng (implicit)
 2012-08-24 22:04:59 +00:00
Gabor Kovesdan
f5b3523ae6 - Properly localize navibar entities 
- Fix enntities of beta releases

Approved by:	doceng (implicit)
 2012-08-24 10:52:17 +00:00
Gabor Kovesdan
975638cb60 - Convert TOPNAV id's to lower case 
Approved by:	doceng (implicit)
 2012-08-23 18:21:47 +00:00
Gabor Kovesdan
2e51ec7022 - Strip unnecessary trailing spaces 
Approved by:	doceng (implicit)
 2012-08-21 19:16:02 +00:00
Gabor Kovesdan
acb8333ccd - Convert more id's and references to lower case 
- Drop upper case support from CSS

Approved by:	doceng (implicit)
 2012-08-19 11:11:51 +00:00
Gabor Kovesdan
16e0394616 - Convert all id names to lowercase 
Approved by:	doceng (implicit)
 2012-08-18 23:43:35 +00:00
Gabor Kovesdan
217c06b0cd - Simplify keyword markup 
- Extract related schema definition into own DTD

Approved by:	doceng (implicit)
 2012-08-13 20:43:41 +00:00
Gabor Kovesdan
6f0813b25d - For non-English pages generate the enbase entity, as well, not just base 
- Remove inline declarations of base and enbase entities since they
  are generated automatically in autogen.ent

Approved by:	doceng (implicit)
 2012-08-13 14:22:30 +00:00
Gabor Kovesdan
77ddadd891 - Add namespace to XHTML fragments generated by XSLT stylesheets 
- Properly define titles, navigation bars and RSS links for generated pages
- Minor cleanup

Approved by:	doceng (implicit)
 2012-08-12 20:35:40 +00:00
Gabor Kovesdan
9b19e6243c - Remove the now unnecessary .decl files 
Approved by:	doceng (implicit)
 2012-08-11 11:16:19 +00:00
Gabor Kovesdan
42b18717e8 - Add proper XML declarations with encoding specification to files that 
didn't yet have it

Approved by:	doceng (implicit)
 2012-08-11 10:37:42 +00:00
Gabor Kovesdan
74586f38c6 - Remove PSGML comments since they are not very useful after the XML 
migration

Approved by:		doceng (implicit)
No objection from:	doc@, www@
 2012-08-07 23:31:39 +00:00
Gabor Kovesdan
d7f1fde5eb - Add a cvs:keyword element to store the $FreeBSD$ keyword for later 
processing
- Date is now obtained from cvs:keyword, so no need for the sed magic

Approved by:	doceng (implicit)
 2012-08-04 22:42:35 +00:00
Gabor Kovesdan
9f996637c9 - XMLify Traditional Chinese webpages 
Approved by:	doceng (implicit)
 2012-08-02 09:00:39 +00:00
Gabor Kovesdan
b9ed398183 - XMLify the Traditional Chinese tree 
- Entity cleanup

Approved by:	doceng (implicit)
 2012-06-24 08:49:38 +00:00