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

805 commits

Author SHA1 Message Date
Gabor Kovesdan
ede3d687bb - Readd mistakently deleted entity definitions 2013-06-20 17:09:52 +00:00
Gabor Kovesdan
aa74e030ad - Properly refer to the glossary 2013-06-20 16:51:23 +00:00
Gabor Kovesdan
cdfb9c36e5 - Convert glossary to normal include file instead of entity so that it can be 
transformed with XSLT
 2013-06-20 16:39:11 +00:00
Gabor Kovesdan
754ee39226 - Eliminate double application element 2013-06-20 16:22:38 +00:00
Gabor Kovesdan
0e4e6a969a - More workarounds for CDATA-related stuff 2013-06-20 14:23:08 +00:00
Gabor Kovesdan
34308163e6 - s/--/-/ in CDATA to help the DB 5.0 conversion script 2013-06-20 14:13:10 +00:00
Gabor Kovesdan
cc22d8bd7c - Add back two accidentally removed entity definitions 2013-06-20 13:41:44 +00:00
Gabor Kovesdan
d1543284b1 - Avoid comments in CDATA sections so that these documents can easily be 
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
 2013-06-20 10:40:37 +00:00
Glen Barber
b648b634f6 Fix syntax from previous commit. 2013-06-18 02:08:55 +00:00
Glen Barber
21dae225c8 Fix build with bmake(1). 
Approved by:	doceng (implicit)
 2013-06-18 00:49:02 +00:00
Gabor Kovesdan
6a004e666b - Add namespace declarations and convert entities to DB 5.0 2013-06-11 09:39:09 +00:00
Gabor Kovesdan
29b0776d82 - Add namespace declaration to trademark entities 2013-06-10 11:36:54 +00:00
Gabor Kovesdan
9b83da790c - Revert r41880 and r41881 since they resulted in loss of semantic 
information

Pointed out by:	hrs
 2013-06-10 09:40:37 +00:00
Gabor Kovesdan
af9e52a7e6 - Avoid trademark in application 2013-06-08 17:27:35 +00:00
Gabor Kovesdan
8a9e685856 - trademark is not allowed in application so just use ™ or ® 2013-06-08 17:20:50 +00:00
Gabor Kovesdan
d0265dd398 - Clean up unused trademark entities 2013-06-08 17:03:03 +00:00
Gabor Kovesdan
e731b1f9a7 - Remove type="html" from ulink 2013-06-03 12:41:52 +00:00
Gabor Kovesdan
ce2cad1acf - bibliography's abstract should be in bibliographyinf 2013-05-31 12:57:11 +00:00
Gabor Kovesdan
c94df498ed - Drop SGML catalogs 
- Drop DSSSL stylesheets
- Drop some DSSSL-related comments and Makefile code
 2013-05-29 19:21:25 +00:00
Gabor Kovesdan
ead03d0553 - Add a missing closing tag 2013-05-23 16:39:25 +00:00
Gabor Kovesdan
500140c3fb - Remove obsolete beginpage 2013-05-23 16:05:46 +00:00
Gabor Kovesdan
7292289d38 - MFH 2013-05-07 10:20:20 +00:00
Gabor Kovesdan
bcd21d65e9 - Reduce the misuse of role attribute; role="directory" should actually be 
class="directory"
 2013-04-04 12:10:48 +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
68645226ea - Replace misused (empty) link elements with xref 2013-04-03 11:33:18 +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
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
3a9b83582b - Use XInclude to include text files instead of <inlinegraphic> since such 
inclusion is not supported in standard XSLT and xsltproc provides no
  extensions for that
 2013-01-30 20:11:31 +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
b7fac26207 - Make the French documentation valid XML 2013-01-21 17:38:45 +00:00
Hiroki Sato
a4266c0837 Fix syntax errors in translated documents. These caused a build breakage in 
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)
 2013-01-09 16:13:30 +00:00
Marc Fonvieille
3f085b381e Fix url entities. 2012-12-30 10:42:02 +00:00
Marc Fonvieille
1e43fa7ef5 Fix urls. 2012-12-30 10:39:51 +00:00
Marc Fonvieille
13d3577699 Unbreak build. 2012-12-30 10:29:52 +00:00
Marc Fonvieille
5f44fab928 No need of localized urls (remain of the past). 2012-12-29 18:43:32 +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
c96a4769af - Remove stale articles and a book 
Discussed with:	blackend
 2012-09-24 10:54:28 +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
0d49ae7c20 - Fix a typo; PUBLIC identifiers are case-sensitive 2012-09-14 21:37:14 +00:00
Gabor Kovesdan
9c243757ef - XML declarations should use IANA encoding names 
Pointed out by:	hrs
 2012-09-14 17:47:48 +00:00
Gabor Kovesdan
c61da2b6d9 - Fix a typo 
Spotted by:	gjb
 2012-09-14 15:10:22 +00:00
Gabor Kovesdan
165056d894 Merge the projects/sgml2xml branch: 
- 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)
 2012-09-14 12:11:19 +00:00
Gabor Kovesdan
617a3c9b13 - Convert character entities to normal characters 
Approved by:	doceng (implicit)
 2012-09-14 09:57:47 +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
763dee20eb - MFH 
Approved by:	doceng (implicit)
 2012-08-27 11:43:27 +00:00
Marc Fonvieille
4091b57dd8 Hook building-products to the build. 2012-08-25 19:52:34 +00:00
Marc Fonvieille
a8c453bebc Add new translated article (building-products) 
PR:		docs/161804
Submitted by:	Frederic Culot <culot@FreeBSD.org>
 2012-08-25 19:51:06 +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
2e51ec7022 - Strip unnecessary trailing spaces 
Approved by:	doceng (implicit)
 2012-08-21 19:16:02 +00:00
Gabor Kovesdan
b92ed28d92 - Fix build of cluster-specific file 
Approved by:	doceng (implicit)
 2012-08-20 13:55:48 +00:00
Gabor Kovesdan
7ba98a21ad MFH 
Approved by:	doceng (implicit)
 2012-08-19 23:05:52 +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
552c6a7fa5 - Fix typo 
Approved by:	doceng (implicit)
 2012-08-18 22:05:53 +00:00
Gabor Kovesdan
f77daa56e0 - Properly copy XHTML fragments by adding namespace 
- 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)
 2012-08-15 21:50:43 +00:00
Gabor Kovesdan
89b9da42e7 - Remove unused ia64 news files 
Approved by:	doceng (implicit)
 2012-08-13 20:58:20 +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
7612b1576b - Fetch the LEGAL file instead of checking it out from CVS; it does not 
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)
 2012-08-10 10:15:50 +00:00
Gabor Kovesdan
44ff87d9fa - Expand character entities in the French documentation 
Approved by:	doceng (implicit)
 2012-08-09 22:39:25 +00:00
Gabor Kovesdan
02b9b66090 - Remove empty class attributes that slipped in with the XML migration 
Approved by:	doceng (implicit)
 2012-08-09 22:02:58 +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
9b77547545 - XMLify sitemap and site index 
Approved by:	doceng (implicit)
 2012-08-05 13:41:44 +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
5f86a171af - Remove forgotten leftover 
Approved by:	doceng (implicit)
 2012-08-04 22:24:24 +00:00
Gabor Kovesdan
d649b89836 - Rename files that were converted to static pages and hook 
them up to the build

Approved by:	doceng (implicit)
 2012-08-04 18:27:50 +00:00
Gabor Kovesdan
1a3bce7da0 - Convert these stylesheets to static pages since there is no actual 
dynamic content

Approved by:	doceng (implicit)
 2012-08-04 18:24:54 +00:00
Gabor Kovesdan
9977e32c49 - Drop HTML Tidy support on webpages; on articles/books it is still used 
since the default HTML output is not that clean

Approved by:	doceng (implicit)
 2012-08-04 17:56:04 +00:00
Gabor Kovesdan
9963e6bc57 - XMLify French webpages 
(Note: old leftovers from commercial/ have been dropped since they are
extremely outdated and the generation process is very complicated.)

Approved by:	doceng (implicit)
 2012-08-01 19:06:15 +00:00
Marc Fonvieille
695b44a8f1 Hook linux-users to the build. 2012-07-04 20:07:28 +00:00
Marc Fonvieille
87fca66d32 Add translated version of articles/linux-users 
PR:		docs/160827
Submitted by:	Frederic Culot <culot@FreeBSD.org>
 2012-07-04 20:05:09 +00:00
Marc Fonvieille
c622ecb1ce MFen: --> 38826 
PR:		docs/168973
Submitted by:	Frederic Culot <culot@freebsd.org>
 2012-06-25 19:16:09 +00:00
Marc Fonvieille
078a51a1d6 MFen: --> 39039 
PR:		docs/169342
Submitted by:	Frederic Culot <culot@FreeBSD.org>
 2012-06-24 19:43:08 +00:00
Gabor Kovesdan
d9c1ad40ed - Fix remaining build errors 
Approved by:	doceng (implicit)
 2012-06-24 17:43:09 +00:00
Gabor Kovesdan
f2ecf8111b - XMLify the French tree 
- Entity cleanup

Approved by:	doceng (implicit)
 2012-06-24 06:58:25 +00:00