Commit graph

459 commits

Author SHA1 Message Date
Marc Fonvieille
a25bf53760 Add id attribute to legal notices to prevent filenames with
auto-generated names.  This will help to track built/installed files
and will ease the packages managing.

Approved by:	doceng (implicit)
2013-06-30 15:08: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
b1f6349527 - MFH 2013-03-20 21:05:33 +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
Giorgos Keramidas
5340c99b42 Misc igor-inspired fixes
- Use an entity to consistently type 'nVidia' with the right
  capitalization (which also 'hides' the weird capitalization
  from igor, and fixes some of its warnings).
- Capitalize section titles correctly
- Reindent some tags that were mis-aligned with their parent.

Approved by:	gjb (mentor)
2013-03-10 13:59:53 +00:00
Giorgos Keramidas
0b770ed2d8 Whitespace changes only: fix most of igor's warnings
Approved by:	gjb (mentor)
2013-03-10 13:58:34 +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
f5b13d3d30 - Clean up more DSSSL leftovers 2013-02-19 17:08:14 +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
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
ef2fe332c0 - Make the Greek documentation valid XML 2013-01-21 17:36:29 +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
efe7023c1f - Encoding names should be IANA names and in lower case 2012-09-22 20:09:08 +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
9c243757ef - XML declarations should use IANA encoding names
Pointed out by:	hrs
2012-09-14 17:47:48 +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
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
7ba98a21ad MFH
Approved by:	doceng (implicit)
2012-08-19 23:05:52 +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
Manolis Kiagias
a5d2253c10 Second batch of updates to the Greek Handbook
This updates the remainder of the (fully translated) chapters:

- introduction (SRCID only) 	r39262
- kernelconfig			r39097
- printing			r38826
- linuxemu			r38826
- boot				r38826
- users				r39362
- jails				r38826
- geom				r38826
- filesystems			r39361
- vinum				r38826
- virtualization		r39283
- l10n				r38826
- cutting-edge			r38879
- dtrace			r38826
- serialcomms			r38826
- ppp-and-slip			r39010
- mail				r38826
- firewalls			r39270
- mirrors			r39186
- bibliography			r39056
- pgpkeys			r39297
- colophon			r38826

Also updates:

- mailing-lists.ent
- trademarks.ent

Obtained from:	FreeBSD Greek Documentation Project
2012-08-11 16:27:35 +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
Manolis Kiagias
bab6c36d55 First of a batch of updates to bring the Greek Documentation Project
back on track and in sync with the en_US tree.

This updates the following chapters of the Greek Handbook:

- book.sgml
- preface
- introduction
- install
- bsdinstall
- basics
- ports
- x11
- desktop
- multimedia

Changes include merging updated content from the en_US tree as well as new
SRCID numbers to reflect SVN revisions.

Obtained from:	FreeBSD Greek Documentation Project
2012-08-10 13:18:37 +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
f60009ae7c - XMLify the Greek tree
- Entity cleanup

Approved by:	doceng (implicit)
2012-06-24 06:57:12 +00:00
Hiroki Sato
35babe0ae5 - Set svn:ketwords and svn:mime-type. Note that application/octet-stream is
set on some files as a workaround for binary check.
- Fix pathname for svn co in the webupdate script.

Approved by:	doceng (implicit)
2012-05-17 19:12:14 +00:00
Hiroki Sato
4fe414e55f - Move developers.sgml to the language-independent directory.
- 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)
2012-05-17 03:23:15 +00:00
Hiroki Sato
282a032540 - Remove junk directories.
- 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)
2012-05-17 02:51:08 +00:00
Doug Barton
58189f49fe Remove references to set_rcvar, which has been removed from 10-current.
While I'm here, bring some consistency to the various example rc.d scripts,
remove some bad examples, etc.
2012-01-14 23:16:00 +00:00
Manolis Kiagias
09d84b2924 Update the Greek Handbook to the latest changes
MFen:

1.178 -> 1.179	book.sgml
1.140 -> 1.141	introduction
1.502 -> 1.503	mirrors
1.131 -> 1.139	freebsd.ent

Obtained from:	FreeBSD Greek Documentation Project
2012-01-14 19:34:16 +00:00
Manolis Kiagias
efb8bf7777 Update the Greek Handbook to the latest changes
MFen:

1.143 -> 1.144	multimedia

Obtained from:	FreeBSD Greek Documentation Project
2012-01-09 21:51:49 +00:00
Manolis Kiagias
9e0c7acbb5 Update the Greek Handbook to the latest changes
MFen:

1.119 -> 1.120	desktop
1.23  -> 1.24	bsdinstall

Obtained from:	FreeBSD Greek Documentation Project
2012-01-09 18:42:17 +00:00
Manolis Kiagias
7d30cc0e12 Update the Greek Handbook to the latest changes
MFen:

1.215 -> 1.216	eresources
1.22  -> 1.23	bsdinstall
1.433 -> 1.434	install
1.86  -> 1.87	mailing-lists.ent

Obtained from:	FreeBSD Greek Documentation Project
2011-12-31 12:53:11 +00:00