diff options
author | Pierre Labastie <pieere@linuxfromscratch.org> | 2020-03-13 09:20:45 +0000 |
---|---|---|
committer | Pierre Labastie <pieere@linuxfromscratch.org> | 2020-03-13 09:20:45 +0000 |
commit | 2e524f93fc03353e6fb05333d8041505948959eb (patch) | |
tree | 0e2f8a60e47c994d49152b300f0d698a7eb29c4f /stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/man.endnotes.are.numbered.xml | |
parent | cc98817b6165e5307c1fc38328cdc2a1cc2de257 (diff) |
Since LFS started using docbook-1.78.1, there is a lot of unused data
in the stylesheet directory. Basically, a whole docbook-stylesheet is
there, while we need only fo and xhtml (+ some common dirs). Each time
we checkout the repo, we have to download this whole thing, which is by
far the biggest part of the repo (~33 M). By removing unused cruft,
this could be down to ~12 M.
Of course, it would be even better to remove completely the stylesheets
and use host ones (repo size down to 2M). but let's do this first, it is
easier :)
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11778 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
Diffstat (limited to 'stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/man.endnotes.are.numbered.xml')
-rw-r--r-- | stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/man.endnotes.are.numbered.xml | 106 |
1 files changed, 0 insertions, 106 deletions
diff --git a/stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/man.endnotes.are.numbered.xml b/stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/man.endnotes.are.numbered.xml deleted file mode 100644 index b069ec3ed..000000000 --- a/stylesheets/lfs-xsl/docbook-xsl-1.78.1/params/man.endnotes.are.numbered.xml +++ /dev/null @@ -1,106 +0,0 @@ -<refentry xmlns="http://docbook.org/ns/docbook" - xmlns:xlink="http://www.w3.org/1999/xlink" - xmlns:xi="http://www.w3.org/2001/XInclude" - xmlns:src="http://nwalsh.com/xmlns/litprog/fragment" - xmlns:xsl="http://www.w3.org/1999/XSL/Transform" - version="5.0" xml:id="man.endnotes.are.numbered"> -<refmeta> -<refentrytitle>man.endnotes.are.numbered</refentrytitle> -<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> -</refmeta> -<refnamediv> -<refname>man.endnotes.are.numbered</refname> -<refpurpose>Number endnotes?</refpurpose> -</refnamediv> - -<refsynopsisdiv> -<src:fragment xml:id="man.endnotes.are.numbered.frag"> -<xsl:param name="man.endnotes.are.numbered">1</xsl:param> -</src:fragment> -</refsynopsisdiv> - -<refsection><info><title>Description</title></info> - -<para>If the value of <parameter>man.endnotes.are.numbered</parameter> is -non-zero (the default), then for each non-empty<footnote> -<para>A “non-empty” notesource is one that looks like -this:<literallayout class="monospaced"> <ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/">manpages</ulink></literallayout> -an “empty” notesource is on that looks like this:<literallayout class="monospaced"> <ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/"/></literallayout> -</para></footnote> “notesource”: - -<itemizedlist> - <listitem> - <para>a number (in square brackets) is displayed inline after the - rendered inline contents (if any) of the notesource</para> - </listitem> - <listitem> - <para>the contents of the notesource are included in a - numbered list of endnotes that is generated at the end of - each man page; the number for each endnote corresponds to - the inline number for the notesource with which it is - associated</para> - </listitem> -</itemizedlist> -The default heading for the list of endnotes is -<literal>NOTES</literal>. To output a different heading, set a value -for the <parameter>man.endnotes.section.heading</parameter> -parameter.</para> - -<note> - <para>The endnotes list is also displayed (but without - numbers) if the value of - <parameter>man.endnotes.list.enabled</parameter> is - non-zero.</para> -</note> - - -<para>If the value of <parameter>man.endnotes.are.numbered</parameter> is -zero, numbering of endnotess is suppressed; only inline -contents (if any) of the notesource are displayed inline. -<important> - <para>If you are thinking about disabling endnote numbering by setting - the value of <parameter>man.endnotes.are.numbered</parameter> to zero, - before you do so, first take some time to carefully - consider the information needs and experiences of your users. The - square-bracketed numbers displayed inline after notesources may seem - obstrusive and aesthetically unpleasing<footnote><para>As far as notesources that are links, ytou might - think it would be better to just display URLs for non-empty - links inline, after their content, rather than displaying - square-bracketed numbers all over the place. But it's not better. In - fact, it's not even practical, because many (most) URLs for links - are too long to be displayed inline. They end up overflowing the - right margin. You can set a non-zero value for - <parameter>man.break.after.slash</parameter> parameter to deal with - that, but it could be argued that what you end up with is at least - as ugly, and definitely more obstrusive, then having short - square-bracketed numbers displayed inline.</para></footnote>, - - but in a text-only output format, the - numbered-notesources/endnotes-listing mechanism is the only - practical way to handle this kind of content.</para> - - <para>Also, users of “text based” browsers such as - <command>lynx</command> will already be accustomed to seeing inline - numbers for links. And various "man to html" applications, such as - the widely used <command><link xlink:href="http://users.actrix.gen.nz/michael/vhman2html.html">man2html</link></command> (<literal>VH-Man2html</literal>) - application, can automatically turn URLs into "real" HTML hyperlinks - in output. So leaving <parameter>man.endnotes.are.numbered</parameter> - at its default (non-zero) value ensures that no information is - lost in your man-page output. It just gets - “rearranged”.</para> -</important> -</para> -<para>The handling of empty links is not affected by this -parameter. Empty links are handled simply by displaying their URLs -inline. Empty links are never auto-numbered.</para> - -<para>If you disable endnotes numbering, you should probably also set -<parameter>man.font.links</parameter> to an empty value (to -disable font formatting for links.</para> -</refsection> - -<refsection><info><title>Related Parameters</title></info> - <para><parameter>man.endnotes.list.enabled</parameter>, - <parameter>man.font.links</parameter></para> -</refsection> -</refentry> |