diff options
author | Gabor Kovesdan <gabor@FreeBSD.org> | 2013-06-20 10:40:37 +0000 |
---|---|---|
committer | Gabor Kovesdan <gabor@FreeBSD.org> | 2013-06-20 10:40:37 +0000 |
commit | d1543284b1d334f134d6feefa28ce0f7a5e1224e (patch) | |
tree | 33c6ca15e4dc992e706b17c8ce1fc113db70d72a /zh_TW.Big5/books | |
parent | 71e721a7b688172c8647e387b303bd043a5f209d (diff) | |
download | doc-d1543284b1d334f134d6feefa28ce0f7a5e1224e.tar.gz doc-d1543284b1d334f134d6feefa28ce0f7a5e1224e.zip |
- 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
Notes
Notes:
svn path=/projects/db5/; revision=41955
Diffstat (limited to 'zh_TW.Big5/books')
-rw-r--r-- | zh_TW.Big5/books/fdp-primer/sgml-markup/chapter.xml | 28 | ||||
-rw-r--r-- | zh_TW.Big5/books/fdp-primer/sgml-primer/chapter.xml | 55 |
2 files changed, 24 insertions, 59 deletions
diff --git a/zh_TW.Big5/books/fdp-primer/sgml-markup/chapter.xml b/zh_TW.Big5/books/fdp-primer/sgml-markup/chapter.xml index fa33335ce8..cf77daf84c 100644 --- a/zh_TW.Big5/books/fdp-primer/sgml-markup/chapter.xml +++ b/zh_TW.Big5/books/fdp-primer/sgml-markup/chapter.xml @@ -148,21 +148,21 @@ <para>Use:</para> - <programlisting><![CDATA[<h1>First section</h1> + <programlisting><h1>First section</h1> -<!-- Document introduction goes here --> +<!‐- Document introduction goes here -‐> -<h2>This is the heading for the first section</h2> +<h2>This is the heading for the first section</h2> -<!-- Content for the first section goes here --> +<!‐- Content for the first section goes here -‐> -<h3>This is the heading for the first sub-section</h3> +<h3>This is the heading for the first sub-section</h3> -<!-- Content for the first sub-section goes here --> +<!‐- Content for the first sub-section goes here -‐> -<h2>This is the heading for the second section</h2> +<h2>This is the heading for the second section</h2> -<!-- Content for the second section goes here -->]]></programlisting> +<!‐- Content for the second section goes here -‐></programlisting> </example> <para>Generally, an HTML page should have one first level heading @@ -179,13 +179,13 @@ <para>Use:</para> - <programlisting><![CDATA[<h1>First section</h1> + <programlisting><h1>First section</h1> -<!-- Document introduction --> +<!‐- Document introduction -‐> -<h3>Sub-section</h3> +<h3>Sub-section</h3> -<!-- This is bad, <h2> has been left out -->]]></programlisting> +<!‐- This is bad, <h2> has been left out -‐></programlisting> </example> </sect3> @@ -455,10 +455,6 @@ </tr> <tr> - <!-- Because the large cell on the left merges into - this row, the first <td> will occur on its - right --> - <td>Middle right cell</td> </tr> diff --git a/zh_TW.Big5/books/fdp-primer/sgml-primer/chapter.xml b/zh_TW.Big5/books/fdp-primer/sgml-primer/chapter.xml index 238c3a4d66..9ccf202d7e 100644 --- a/zh_TW.Big5/books/fdp-primer/sgml-primer/chapter.xml +++ b/zh_TW.Big5/books/fdp-primer/sgml-primer/chapter.xml @@ -818,40 +818,18 @@ nsgmls:example.xml:6:8:E: end tag for "HEAD" which is not finished</screen> <programlisting><!-- 測試註解 --></programlisting> - <programlisting><![CDATA[ -<!-- 這是註解 --> + <programlisting> +<!‐- 這是註解 -‐> -<!-- 這也是註解 --> +<!‐- 這也是註解 -‐> -<!-- 要寫多行註解的話, - 這是其中之一的方式 --> +<!‐- 要寫多行註解的話, + 這是其中之一的方式 -‐> -<!-- 要寫多行註解, -- - -- 也可以這樣子用 -->]]></programlisting> +<!‐- 要寫多行註解, -‐ + ‐- 也可以這樣子用 -‐></programlisting> </example> -<!-- - <![%output.print;[ - <important> - <title>Use 2 dashes</title> - - <para>There is a problem with producing the Postscript and PDF versions - of this document. The above example probably shows just one hyphen - symbol, <literal>-</literal> after the <literal><!</literal> and - before the <literal>></literal>.</para> - - <para>You <emphasis>must</emphasis> use two <literal>-</literal>, - <emphasis>not</emphasis> one. The Postscript and PDF versions have - translated the two <literal>-</literal> in the original to a longer, - more professional <emphasis>em-dash</emphasis>, and broken this - example in the process.</para> - - <para>The HTML, plain text, and RTF versions of this document are not - affected.</para> - </important> - ]]> ---> - <para>If you have used HTML before you may have been shown different rules for comments. In particular, you may think that the string <literal><!--</literal> opens a comment, and it is only closed by @@ -865,12 +843,12 @@ nsgmls:example.xml:6:8:E: end tag for "HEAD" which is not finished</screen> <example> <title>Erroneous SGML comments</title> - <programlisting><![CDATA[ -<!-- This is in the comment -- + <programlisting> +<!‐- This is in the comment -‐ THIS IS OUTSIDE THE COMMENT! - -- back inside the comment -->]]></programlisting> + ‐- back inside the comment -‐></programlisting> <para>The SGML parser will treat this as though it were actually:</para> @@ -879,12 +857,12 @@ nsgmls:example.xml:6:8:E: end tag for "HEAD" which is not finished</screen> <para>This is not valid SGML, and may give confusing error messages.</para> - <programlisting><![CDATA[<!--------------- This is a very bad idea --------------->]]></programlisting> + <programlisting><!‐‐‐‐‐ This is a very bad idea ‐‐‐‐‐></programlisting> <para>As the example suggests, <emphasis>do not</emphasis> write comments like that.</para> - <programlisting><![CDATA[<!--===================================================-->]]></programlisting> + <programlisting><!‐-===================================================-‐></programlisting> <para>That is a (slightly) better approach, but it still potentially confusing to people new to SGML.</para> @@ -1011,8 +989,6 @@ nsgmls:example.xml:6:8:E: end tag for "HEAD" which is not finished</screen> <!ENTITY % param.some "some"> <!ENTITY % param.text "text"> <!ENTITY % param.new "%param.some more %param.text"> - -<!-- %param.new now contains "some more text" --> ]>]]></programlisting> </example> @@ -1036,8 +1012,6 @@ nsgmls:example.xml:6:8:E: end tag for "HEAD" which is not finished</screen> <title>An example HTML file</title> </head> - <!-- You might well have some comments in here as well --> - <body> <p>This is a paragraph containing some text.</p> @@ -1129,11 +1103,9 @@ nsgmls:example.xml:6:8:E: end tag for "HEAD" which is not finished</screen> <!ENTITY chapter.1 SYSTEM "chapter1.xml"> <!ENTITY chapter.2 SYSTEM "chapter2.xml"> <!ENTITY chapter.3 SYSTEM "chapter3.xml"> -<!-- And so forth --> ]> <html> - <!-- Use the entities to load in the chapters --> &chapter.1; &chapter.2; @@ -1189,10 +1161,7 @@ nsgmls:example.xml:6:8:E: end tag for "HEAD" which is not finished</screen> for use. Then use the general entities as before:</para> <programlisting><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [ -<!-- Define a parameter entity to load in the chapter general entities --> <!ENTITY % chapters SYSTEM "chapters.ent"> - -<!-- Now use the parameter entity to load in this file --> %chapters; ]> |