os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
GayBSD documentation tree
12902 commits 1 branch 79 tags 298 MiB
HTML 99.4%
CSS 0.3%
Perl 0.2%
Find a file
Murray Stokely 54ab45e845 Add support for building documents in our doc/ tree marked up in 
Norman Walsh's DocBook Slides DTD.

This DTD offers the vocabulary of simplified DocBook for
presentations.  Initially, the supported output formats are PDF and
HTML.

XSL stylesheets are used so libxslt is required.

PassiveTeX is used for the PDF generation to convert the XSL-FO
directly to PDF.

This commit moves various TeX definitions out of doc.docbook.mk and
into doc.project.mk, since docbook is no longer the only back-end to
utilize TeX.

An example Makefile would look like :

----
DOCFORMAT=	slides
DOC=		slides

SRCS=	slides.xml

DOC_PREFIX?=	${.CURDIR}/../../..
.include "${DOC_PREFIX}/share/mk/doc.project.mk"
---

And an example slides file (slides.xml) looks like :

---
<!DOCTYPE slides PUBLIC "-//Norman Walsh//DTD Slides XML V3.3.1//EN"
  "http://docbook.sourceforge.net/releases/slides/3.3.1/slides.dtd">
<slides>
<slidesinfo>
  <title>What's new in FreeBSD 5.3</title>
  <titleabbrev>FreeBSD 5.3</titleabbrev>
</slidesinfo>

<foil><title>Introduction Slide</title>
  <para>Content</para>
</foil>
</slides>
---

You could then build the HTML and PDF versions of the slides by typing
"make FORMATS='pdf html'".  Enjoy.

Please coordinate with doceng@ before importing any presentations to
doc/.
2004-09-02 17:12:14 +00:00
bn_BD.ISO10646-1 Add Bangla translation of the Explaining BSD and FreeBSD First Steps 2004-02-16 23:56:26 +00:00
da_DK.ISO8859-1 Fix missing termination of the the a.majordomo entity. 2004-08-26 12:49:27 +00:00
de_DE.ISO8859-1 Fix build of DE release notes after introduction of articles.ent and books.ent 2004-08-20 15:29:40 +00:00
el_GR.ISO8859-7 Simplify the doc/el_GR Makefiles by avoiding unnecessary local 2004-07-30 12:01:09 +00:00
en/handbook/contrib Add Frank Mayhar for p5-libapreq. 2000-03-19 06:20:31 +00:00
en_US.ISO8859-1 Add 7 Chinese FreeBSD books to the bibliography. (Simplified Chinese 2004-09-02 11:22:44 +00:00
es_ES.ISO8859-1 Typo fix. 2004-04-04 21:05:30 +00:00
fr_FR.ISO8859-1 MFen 1.350 --> 1.351 2004-08-25 09:52:20 +00:00
it_IT.ISO8859-15 Update Italian Documentation. 2004-08-25 09:30:32 +00:00
ja_JP.eucJP Initial Japanese Translation of kse.2. 2004-09-01 14:37:33 +00:00
nl_NL.ISO8859-1 Move ($create-refentry-xref-link$) to share/sgml/freebsd.dsl 2003-05-22 15:03:50 +00:00
no_NO.ISO8859-1 Add some basic Makefiles. 2004-08-23 19:13:17 +00:00
pl_PL.ISO8859-2 Add doc.local.mk for ISO8859-2 encodings 2004-08-10 06:51:25 +00:00
pt_BR.ISO8859-1 Connect newly added articles subdirectory to the build 2003-12-29 04:28:54 +00:00
release Make this more like a "real" release from src. Rather than building 2003-06-05 23:42:16 +00:00
ru_RU.KOI8-R Fix url remapping 2004-08-31 13:17:52 +00:00
share Add support for building documents in our doc/ tree marked up in 2004-09-02 17:12:14 +00:00
sr_YU.ISO8859-2 Add doc.local.mk for ISO8859-2 encodings 2004-08-10 06:51:25 +00:00
tr_TR.ISO8859-9 Say hello to the 1st effort of the Turkish Translation Team. 2003-10-04 10:06:30 +00:00
zh/FAQ Correct the "ID" tag. 1999-11-12 08:34:11 +00:00
zh_TW.Big5 Move ($create-refentry-xref-link$) to share/sgml/freebsd.dsl 2003-05-22 15:03:50 +00:00
Makefile Add Bangla translations to the build. 2004-02-17 00:14:11 +00:00
README Correct link to the Doc Project Primer. 2001-10-13 19:18:55 +00:00

README 

$FreeBSD$

If you plan on building a local copy of the FreeBSD documentation, or using
our toolchain in your own projects, please read

    http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/fdp-primer/

for information about the tools and formatting languages we use.  Chapter
2 covers the software and related items you will need to install.