diff options
Diffstat (limited to 'ja_JP.eucJP/books/fdp-primer/stylesheets/chapter.xml')
-rw-r--r-- | ja_JP.eucJP/books/fdp-primer/stylesheets/chapter.xml | 104 |
1 files changed, 104 insertions, 0 deletions
diff --git a/ja_JP.eucJP/books/fdp-primer/stylesheets/chapter.xml b/ja_JP.eucJP/books/fdp-primer/stylesheets/chapter.xml new file mode 100644 index 0000000000..a677a81f54 --- /dev/null +++ b/ja_JP.eucJP/books/fdp-primer/stylesheets/chapter.xml @@ -0,0 +1,104 @@ +<?xml version="1.0" encoding="euc-jp" standalone="no"?> +<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved. + + Redistribution and use in source (SGML DocBook) and 'compiled' forms + (SGML HTML, PDF, PostScript, RTF and so forth) with or without + modification, are permitted provided that the following conditions + are met: + + 1. Redistributions of source code (SGML DocBook) must retain the above + copyright notice, this list of conditions and the following + disclaimer as the first lines of this file unmodified. + + 2. Redistributions in compiled form (transformed to other DTDs, + converted to PDF, PostScript, RTF and other formats) must reproduce + the above copyright notice, this list of conditions and the + following disclaimer in the documentation and/or other materials + provided with the distribution. + + THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR + IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT, + INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR + SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, + STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN + ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + + + The FreeBSD Japanese Documentation Project + + Original revision: 1.10 + $FreeBSD$ +--> + +<chapter id="stylesheets"> + <title>* スタイルシート</title> + + <para>SGML は、文書が利用者にどのように表示されるかということや、 + 紙の上にどう配置されるかということについては何も定義していません。 + それらを行なうためにスタイルシートを記述するさまざまな言語が開発されています。 + その言語には、DynaText, Panorama, SPICE, JSSS, FOSI, CSS, DSSSL + などがあります。 + </para> + + <para>わたしたちは、DocBook 文書用として DSSSL で書かれたスタイルシートを、 + HTML 文書用として CSS を利用しています。</para> + + <sect1 id="stylesheets-dsssl"> + <title>* DSSSL</title> + + <para>ドキュメンテーションプロジェクトでは、 + Norm Walsh 氏による Modular DocBook Stylesheets + を少しカスタマイズしたものを使っています。</para> + + <para>このスタイルシートは、 + <filename role="package">textproc/dsssl-docbook-modular</filename> + から入手できます。</para> + + <para>変更が加えられたスタイルシートは、ports システムに含まれていません。 + それらはドキュメンテーションプロジェクトのソースリポジトリの一部であり、 + <filename>doc/share/sgml/freebsd.dsl</filename> におかれています。 + 変更が加えられたスタイルシートには詳細なコメントが付けられていますので、 + この章が完成するまで、標準のスタイルシートにあるオプションが + どういった風に FreeBSD ドキュメンテーションプロジェクト用に + カスタマイズされているのか、このファイルを見て調べてみてください。 + このファイルには FreeBSD 独自のエレメントを組版するために + スタイルシートを適用するエレメントを追加する方法の例も含まれています。 + </para> + </sect1> + + <sect1 id="stylesheets-css"> + <title>CSS</title> + + <para>Cascading Stylesheets (CSS) はスタイル情報 + (フォント、ウェイト、大きさ、色などなど) + を HTML 文書の要素に付加する機構です。</para> + + <sect2> + <title>ウェブサイト (HTML 文書)</title> + + <para>FreeBSD のウェブサイトは現在 CSS を使用していません。 + 残念ながら、見た目とその印象は HTML の各属性で直接調整されており、 + 人によってその度合は異なります。 + この問題は解決すべきであり、ドキュメンテーションプロジェクトに + 貢献するに値する良いプロジェクトになるでしょう。</para> + </sect2> + + <sect2> + <title>DocBook 文書</title> + + <para>FreeBSD の DSSSL スタイルシートには、スタイルシート + <filename>docbook.css</filename> への参照が含まれています。 + このスタイルシートは HTML ファイルと同一のディレクトリに + 存在することが想定されています。 + プロジェクトにまたがる CSS ファイルは、 + 文書が HTML に変換される時に + <filename>doc/share/misc/docbook.css</filename> + から複製され、自動的にインストールされます。</para> + </sect2> + </sect1> +</chapter> |