Commit graph

33 commits

Author SHA1 Message Date
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
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
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
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
Gabor Kovesdan
9c243757ef - XML declarations should use IANA encoding names
Pointed out by:	hrs
2012-09-14 17:47:48 +00:00
Gabor Kovesdan
2e51ec7022 - Strip unnecessary trailing spaces
Approved by:	doceng (implicit)
2012-08-21 19:16:02 +00:00
Gabor Kovesdan
e6b69c3357 - XMLify English articles
Approved by:	doceng (implicit)
2012-06-21 16:01:00 +00:00
Johann Kois
f74d50dc72 Whitespace-change only.
Make the output a little bit more readable by

- addings some list (orderedlist, itemized list)
- adding some additional paragraphs
- rearranging the Q/A section so that something useful is displayed in the list of Q/A.

Suggested by:   Benjamin Lukas (qavvap att googlemail dott com)
2010-06-17 11:24:25 +00:00
Johann Kois
77f5bcecff s/FreeBSD/&os;/
Suggested by:   Benjamin Lukas (qavvap att googlemail dott com)
2010-06-17 09:19:58 +00:00
Daniel Gerzo
ed2cda15f0 Fix typos.
PR: docs/103327
Approved by: trhodes (mentor), keramida (mentor)
2006-09-24 13:36:59 +00:00
Ceri Davies
67b89c0765 Add id attributes to sectN elements to stop jade inventing filenames for
the html-split output.
2005-02-17 20:38:19 +00:00
Hiroki Sato
5fa082b1f8 Simplify parameter entities in doctype declaration.
Currently we have articles.ent and books.ent, and
for example, articles.ent can be used by putting the
following lines in the doctype declaration:

 <!ENTITY % articles.ent PUBLIC
            "-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//EN">
 %articles.ent;

This pulls all of the necessary entities via share/sgml/articles.ent.

The translation teams can customize these entities by redefining
the articles.ent file in <langcode>/share/sgml.  See
ja_JP.eucJP/share/sgml for example.
2004-08-08 13:44:01 +00:00
Alexey Zelkin
6d048e2320 Sync these Makefiles to have one style of declarations and comments. 2004-04-06 16:10:08 +00:00
Alexey Zelkin
2e0fdd35b2 Add WITH_ARTICLE_TOC to big articles to simplify navigation across
article.
2004-04-06 13:40:48 +00:00
Simon L. B. Nielsen
09f3c92252 - Use trademark entities.
- Add trademark attributions.
2003-10-18 10:39:16 +00:00
Murray Stokely
a4085987a0 Include FreeBSD entity definitions, and use &unix instead of 'UNIX' to
render a (R) after the first occurrence of that word.
2003-06-17 21:10:45 +00:00
Hiroki Sato
f6cd99b654 Back out WITH_DOCFORMAT_NAVI_LINK?=YES in Makefile. The navi-link
is generated when ${WITH_DOCFORMAT_NAVI_LINK} is defined or
${FORMATS} includes "html" and "html-split."
2003-04-22 18:35:44 +00:00
Hiroki Sato
4f8b26641c - Add WITH_DOCFORMAT_NAVI_LINK to mk/doc.docbook.mk and
enable it in en_US.ISO8859-1/ and ja_JP.eucJP/.

- Add PUBLIC "-//FreeBSD//ENTITIES DocBook Language Specific Entities//EN"
  and l10n.ent for entity localization.

- Use share/misc/docbook.css for indentiation of <programlisting>
  and <screen>.

- Add some missing $FreeBSD$.
2003-04-19 11:39:30 +00:00
Marc Fonvieille
48467978c1 Remove images moved to share/images/articles. 2003-04-11 09:28:13 +00:00
Marc Fonvieille
47f6d4e260 Commit images separation from en_US.ISO8859-1/ directory to
share/images.  To link "generic" images (share/images ones) from
Makefiles use IMAGES_EN and to link localized images use IMAGES.
For an example look at en_US.ISO8859-1/books/handbook/Makefile
2003-04-11 09:21:15 +00:00
Jim Mock
7e5229d6dc X.x -> X.X when mentioning FreeBSD branches to be consistent with the
rest of the doc tree.

PR:		38777
Submitted by:	blackend
2002-07-03 23:19:12 +00:00
Giorgos Keramidas
d690a988f5 Change most quote characters to proper <quote> tags,
or other more appropriate SGML entities.
2002-02-14 23:57:13 +00:00
Giorgos Keramidas
e7655d4598 Whitespace fixes.
Punctuation chars should not be preceded by spaces.
2002-02-14 22:31:00 +00:00
Giorgos Keramidas
cd9bff24c3 Remove all contractions used in this article.
Approved by:	nik
2001-10-16 12:05:48 +00:00
Giorgos Keramidas
4593fd98a7 Sweep through english docs and replace &ldquot; and friends with <quote>.
Approved by:	nik
2001-10-10 11:47:30 +00:00
Chern Lee
6dbf07d805 Fix/Standardize:
internet -> Internet
can not -> cannot
CD-ROM -> CDROM
cdrom -> CDROM
UNIX -> Unix

To be standardized with the rest of the doc tree.

Approved by:	murray
2001-07-17 20:51:52 +00:00
Dima Dorfman
afc9adbc29 Spelling police. 2001-07-10 13:24:13 +00:00
Nik Clayton
461c887c87 Update to DocBook 4.1 DTD, tweak the image usage slightly to conform to the
new style.
2001-02-20 19:49:32 +00:00
Ben Smithurst
34f100d8e2 Fix a typo (duplicated "when you").
PR:		24567
Submitted by:	Robert Drehmel <robert@gizmo.quizbot.org>
2001-01-24 11:50:30 +00:00
Nik Clayton
2f261dc497 <literallayout> -> <literallayout class="monospaced">, which is (pedantically)
the correct idiom to use.
2000-10-23 14:42:50 +00:00
Nik Clayton
68b9d2851a This is Matt Dillon's VM Design article from DaemonNews. It's here
a) Because it's a cool piece of documentation

  b) It's a real world example of using images in the documentation.

It's not turned on in the upper level Makefile yet, as I expect the
specifics of the toolchain to change over the next week or so as people
play around with this, and I don't want to the doc build mirrors to have
to suddenly update the ports they have installed.  Once this has stabilised
it can be turned on.
2000-10-08 19:23:10 +00:00