diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/fmtcount/doc/manual.html')
-rw-r--r-- | Master/texmf-dist/doc/latex/fmtcount/doc/manual.html | 567 |
1 files changed, 567 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/fmtcount/doc/manual.html b/Master/texmf-dist/doc/latex/fmtcount/doc/manual.html new file mode 100644 index 00000000000..be8c0b2c915 --- /dev/null +++ b/Master/texmf-dist/doc/latex/fmtcount/doc/manual.html @@ -0,0 +1,567 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> + +<!--Converted with LaTeX2HTML 2002 (1.67) +original version by: Nikos Drakos, CBLU, University of Leeds +* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan +* with significant contributions from: + Jens Lippmann, Marek Rouchal, Martin Wilck and others --> +<HTML> +<HEAD> +<TITLE>fmtcount.sty v1.1: Displaying the Values of LaTeX Counters</TITLE> +<META NAME="description" CONTENT="fmtcount.sty v1.1: Displaying the Values of LaTeX Counters"> +<META NAME="keywords" CONTENT="manual"> +<META NAME="resource-type" CONTENT="document"> +<META NAME="distribution" CONTENT="global"> + +<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> +<META NAME="Generator" CONTENT="LaTeX2HTML v2002"> +<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> + + +</HEAD> + +<BODY > +<A NAME="tex2html1" + HREF="http://theoval.cmp.uea.ac.uk/~nlct/">Dr Nicola Talbot</A> +| +<A NAME="tex2html2" + HREF="http://www.cmp.uea.ac.uk/">School of Computing Sciences</A> +| +<A NAME="tex2html3" + HREF="http://www.uea.ac.uk/">University of East Anglia</A> + +<P> + + <H1 ALIGN="CENTER">fmtcount.sty v1.1: Displaying the Values of +LaTeX Counters</H1> +<P ALIGN="CENTER"><STRONG>Nicola L.C. Talbot</STRONG></P> +<P ALIGN="CENTER"><STRONG>26th May 2007</STRONG></P> + <BR> + +<H2><A NAME="SECTION00010000000000000000"> +Contents</A> +</H2> +<!--Table of Contents--> + +<UL> +<LI><A NAME="tex2html20" + HREF="manual.html#SECTION00020000000000000000">Introduction</A> +<LI><A NAME="tex2html21" + HREF="manual.html#SECTION00030000000000000000">Installation</A> +<LI><A NAME="tex2html22" + HREF="manual.html#SECTION00040000000000000000">Available Commands</A> +<LI><A NAME="tex2html23" + HREF="manual.html#SECTION00050000000000000000">Package Options</A> +<LI><A NAME="tex2html24" + HREF="manual.html#SECTION00060000000000000000">Multilingual Support</A> +<LI><A NAME="tex2html25" + HREF="manual.html#SECTION00070000000000000000">Configuration File fmtcount.cfg</A> +<LI><A NAME="tex2html26" + HREF="manual.html#SECTION00080000000000000000">LaTeX2HTML style</A> +<LI><A NAME="tex2html27" + HREF="manual.html#SECTION00090000000000000000">Acknowledgements</A> +<LI><A NAME="tex2html28" + HREF="manual.html#SECTION000100000000000000000">Troubleshooting</A> +<LI><A NAME="tex2html29" + HREF="manual.html#SECTION000110000000000000000">Contact Details</A> +</UL> +<!--End of Table of Contents--> +<H1><A NAME="SECTION00020000000000000000"> +Introduction</A> +</H1> +The <TT>fmtcount</TT> package provides commands to display +the values of LaTeX counters in a variety of formats. It also +provides equivalent commands for actual numbers rather than +counter names. Limited multilingual support is available. + +<P> + +<H1><A NAME="SECTION00030000000000000000"> +Installation</A> +</H1> + +<P> +This package is distributed with the files <TT>fmtcount.dtx</TT> +and <TT>fmtcount.ins</TT>. To extract the code do: +<PRE> +latex fmtcount.ins +</PRE> +This will create the files <TT>fmtcount.sty</TT> and +<TT>fmtcount.perl</TT>, along with several <TT>.def</TT> files. +Place <TT>fmtcount.sty</TT> and the <TT>.def</TT> files somewhere +where LaTeX will find them (e.g. <TT>texmf/tex/latex/fmtcount/</TT>) and place <TT>fmtcount.perl</TT> somewhere where LaTeX2HTML +will find it (e.g. latex2html/styles). Remember to refresh +the TeX database (using <TT>texhash</TT> under Linux, for +other operating systems check the manual.) + +<P> + +<H1><A NAME="SECTION00040000000000000000"> +Available Commands</A> +</H1> + +<P> +The commands can be divided into two categories: those that +take the name of a counter as the argument, and those +that take a number as the argument. + +<P> +The macro <code>\ordinal{</code><I>counter</I><code>}</code> will + print the value of a LaTeX counter <I>counter</I> as an ordinal, + + where the macro <code>\fmtord{</code><I>text</I><code>}</code> is used to format the st,nd,rd,th bit. + By default the ordinal is formatted as a superscript, if the package option <TT>level</TT> + is used, it is level with the text. + For example, if the current section is 3, then <code>\ordinal{section}</code> will produce + the output: 3<SUP>rd</SUP>. + +<P> +<B>Note:</B> the <TT>memoir</TT> class also defines a command called +<code>\ordinal</code> which takes a number as an argument instead of a +counter. In order to overcome this incompatiblity, if you want +to use the <TT>fmtcount</TT> package with the <TT>memoir</TT> class +you should use <code>\FCordinal</code> to access <TT>fmtcount</TT>'s +version of <code>\ordinal</code>, and use <code>\ordinal</code> to use +<TT>memoir</TT>'s version of that command. + +<P> +The macro <code>\ordinalnum</code> is like <code>\ordinal</code> +but takes an actual number rather than a counter as the +argument. For example: <code>\ordinalnum{3}</code> will +produce: 3<SUP>rd</SUP>. + +<P> +The macro <code>\numberstring{</code><I>counter</I><code>}</code> will print the value + of <I>counter</I> as text. E.g. <code>\numberstring{section}</code> will produce: + three. + + The macro <code>\Numberstring{</code><I>counter</I><code>}</code> does the same as + <code>\numberstring</code>, but with initial letters in uppercase. For + example, <code>\Numberstring{section}</code> will produce: Three. + +The macro <code>\NUMBERstring{</code><I>counter</I><code>}</code> does the same +as <code>\numberstring</code>, but converted to upper case. Note that +<code>\MakeUppercase{\NUMBERstring{</code><I>counter</I><code>}}</code> doesn't +work, due to the way that <code>\MakeUppercase</code> expands its +argument<A NAME="tex2html4" + HREF="#foot290"><SUP>1</SUP></A>. + +<P> +The macros <code>\numberstringnum</code>, +<code>\Numberstringnum</code> and +<code>\NUMBERstringnum</code> work like +<code>\numberstring</code>, +<code>\Numberstring</code> and +<code>\NUMBERstring</code>, respectively, but take an actual number +rather than a counter as the argument. For example: +<code>\Numberstringnum{105}</code> will produce: One Hundred and Five. + +<P> +The macro <code>\ordinalstring{</code><I>counter</I><code>}</code> will print the + value of <I>counter</I> as a textual ordinal. E.g. <code>\ordinalstring{section}</code> will produce: third. + + The macro <code>\Ordinalstring{</code><I>counter</I><code>}</code> does the same as + <code>\ordinalstring</code>, but with initial letters in uppercase. For example, + <code>\Ordinalstring{section}</code> will produce: Third. + + The macro <code>\ORDINALstring{</code><I>counter</I><code>}</code> does the same as +<code>\ordinalstring</code>, but with all words in upper case (see previous +note about <TT>\MakeUppercase</TT>). + +<P> +The macros <code>\ordinalstringnum</code>, +<code>\Ordinalstringnum</code> and <TT>\ORDINALstringnum</TT> work like +<code>\ordinalstring</code>, +<code>\Ordinalstring</code> and <TT>\ORDINALstring</TT>, respectively, but take an actual number +rather than a counter as the argument. For example, +<code>\ordinalstringnum{3}</code> will produce: third. + +<P> +As from version 1.09, textual representations can be stored for +later use. This overcomes the problems encountered when you +attempt to use one of the above commands in <TT>\edef</TT>. + +<P> +Each of the following commands takes a label as the first argument, +the other arguments are as the analogous commands above. These +commands do not display anything, but store the textual +representation. This can later be retrieved using +<TT>\FMCuse</TT>{<I>label</I>}. +Note: with <TT>\storeordinal</TT> and <TT>\storeordinalnum</TT>, the +only bit that doesn't get expanded is <TT>\fmtord</TT>. So, for +example, <code>\storeordinalnum{mylabel}{3}</code> will be stored as +<code>3\relax \fmtord{rd}</code>. + +<P> + +<TT>\storeordinal</TT>{<I>label</I>}{<I>counter</I>}[<I>gender</I>] + +<P> + +<TT>\storeordinalstring</TT>{<I>label</I>}{<I>counter</I>}[<I>gender</I>] + +<P> + +<TT>\storeOrdinalstring</TT>{<I>label</I>}{<I>counter</I>}[<I>gender</I>] + +<P> + +<TT>\storeORDINALstring</TT>{<I>label</I>}{<I>counter</I>}[<I>gender</I>] + +<P> + +<TT>\storenumberstring</TT>{<I>label</I>}{<I>counter</I>}[<I>gender</I>] + +<P> + +<TT>\storeNumberstring</TT>{<I>label</I>}{<I>counter</I>}[<I>gender</I>] + +<P> + +<TT>\storeNUMBERstring</TT>{<I>label</I>}{<I>counter</I>}[<I>gender</I>] + +<P> + +<TT>\storeordinalnum</TT>{<I>label</I>}{<I>number</I>}[<I>gender</I>] + +<P> + +<TT>\storeordinalstring</TT>{<I>label</I>}{<I>number</I>}[<I>gender</I>] + +<P> + +<TT>\storeOrdinalstringnum</TT>{<I>label</I>}{<I>number</I>}[<I>gender</I>] + +<P> + +<TT>\storeORDINALstringnum</TT>{<I>label</I>}{<I>number</I>}[<I>gender</I>] + +<P> + +<TT>\storenumberstring</TT>{<I>label</I>}{<I>number</I>}[<I>gender</I>] + +<P> + +<TT>\storeNumberstring</TT>{<I>label</I>}{<I>number</I>}[<I>gender</I>] + +<P> + +<TT>\storeNUMBERstring</TT>{<I>label</I>}{<I>number</I>}[<I>gender</I>] + +<P> +The macro <code>\binary{</code><I>counter</I><code>}</code> will print the +value of <I>counter</I> as a binary number. +E.g. <code>\binary{section}</code> will produce: 11. The declaration +<code>\padzeroes[</code><I>n</I><code>]</code> +will ensure numbers are written to <I>n</I> digits, padding with +zeroes if necessary. E.g. <code>\padzeroes[8]\binary{section}</code> +will produce: 00000011. + The default value for <I>n</I> is 17. + +<P> +The macro <code>\binarynum</code> is like <code>\binary</code> +but takes an actual number rather than a counter as the +argument. For example: <code>\binarynum{5}</code> will +produce: 101. + +<P> +The macro <code>\octal{</code><I>counter</I><code>}</code> will print the +value of <I>counter</I> as an octal number. For example, if you +have a counter called, say <TT>mycounter</TT>, and you set the +value to 125, then <code>\octal{mycounter}</code> will produce: 177. + Again, the number will be padded with zeroes if necessary, +depending on whether <code>\padzeroes</code> has been used. + +<P> +The macro <code>\octalnum</code> is like <code>\octal</code> +but takes an actual number rather than a counter as the +argument. For example: <code>\octalnum{125}</code> will +produce: 177. + +<P> +The macro <code>\hexadecimal{</code><I>counter</I><code>}</code> will print +the value of <I>counter</I> as a hexadecimal number. Going back +to the previous example, <code>\hexadecimal{mycounter}</code> will + produce: 7d. Again, the number will be padded with zeroes if +necessary, depending on whether <code>\padzeroes</code> has been used. + + <code>\Hexadecimal{</code><I>counter</I><code>}</code> does the same thing, +but uses uppercase characters, e.g. + <code>\Hexadecimal{mycounter}</code> will produce: 7D. + +<P> +The macros <code>\hexadecimalnum</code> and +<code>\Hexadecimalnum</code> are like +<code>\hexadecimal</code> and <code>\Hexadecimal</code> +but take an actual number rather than a counter as the +argument. For example: <code>\hexadecimalnum{125}</code> will +produce: 7d, and <code>\Hexadecimalnum{125}</code> will +produce: 7D. + +<P> +The macro <code>\decimal{</code><I>counter</I><code>}</code> is similar to +<code>\arabic</code> but the number can be padded with zeroes + depending on whether <code>\padzeroes</code> has been used. +For example: <code>\padzeroes[8]\decimal{section}</code> will + produce: 00000005. + +<P> +The macro <code>\decimalnum</code> is like <code>\decimal</code> +but takes an actual number rather than a counter as the +argument. For example: <code>\padzeroes[8]\decimalnum{5}</code> will +produce: 00000005. + +<P> +The macro <code>\aaalph{</code><I>counter</I><code>}</code> will print the +value of <I>counter</I> as: a b ... z aa bb ... zz etc. + For example, <code>\aaalpha{mycounter}</code> will produce: uuuuu if +<TT>mycounter</TT> is set to 125. + + <code>\AAAlph{</code><I>counter</I><code>}</code> does the same thing, but +uses uppercase characters, e.g. + <code>\AAAlph{mycounter}</code> will produce: UUUUU. + +<P> +The macros <code>\aaalphnum</code> and +<code>\AAAlphnum</code> are like +<code>\aaalph</code> and <code>\AAAlph</code> +but take an actual number rather than a counter as the +argument. For example: <code>\aaalphnum{125}</code> will +produce: uuuuu, and <code>\AAAlphnum{125}</code> will +produce: UUUUU. + +<P> +The macro <code>\abalph{</code><I>counter</I><code>}</code> will print the +value of <I>counter</I> as: a b ... z aa ab ... az etc. + For example, <code>\abalpha{mycounter}</code> will produce: du if +<TT>mycounter</TT> is set to 125. + + <code>\ABAlph{</code><I>counter</I><code>}</code> does the same thing, but +uses uppercase characters, e.g. + <code>\ABAlph{mycounter}</code> will produce: DU. + +<P> +The macros <code>\abalphnum</code> and +<code>\ABAlphnum</code> are like +<code>\abalph</code> and <code>\ABAlph</code> +but take an actual number rather than a counter as the +argument. For example: <code>\abalphnum{125}</code> will +produce: du, and <code>\ABAlphnum{125}</code> will +produce: DU. + +<P> + +<H1><A NAME="SECTION00050000000000000000"> +Package Options</A> +</H1> + +<P> +The following options can be passed to this package: + +<P> +<TABLE CELLPADDING=3> +<TR><TD ALIGN="LEFT">raise</TD> +<TD ALIGN="LEFT">make ordinal st,nd,rd,th appear as superscript</TD> +</TR> +<TR><TD ALIGN="LEFT">level</TD> +<TD ALIGN="LEFT">make ordinal st,nd,rd,th appear level with rest of +text</TD> +</TR> +</TABLE> + +<P> +These can also be set using the command: + +<P> + +<code>\fmtcountsetoptions{fmtord=</code><I>type</I><code>}</code> + +<P> +where <I>type</I> is either <TT>level</TT> or +<TT>raise</TT>. + +<P> + +<H1><A NAME="SECTION00060000000000000000"> +Multilingual Support</A> +</H1> + +<P> +Version 1.02 of the <TT>fmtcount</TT> package now has +limited multilingual support. The following languages are +implemented: English, Spanish, Portuguese, French, French (Swiss) +and French (Belgian). German support was added in version +1.1<A NAME="tex2html5" + HREF="#foot244"><SUP>2</SUP></A>. + +<P> +The package checks to see if the +command <code>\date</code><I>language</I> is defined<A NAME="tex2html6" + HREF="#foot291"><SUP>3</SUP></A>, and will +load the code for those languages. The commands <code>\ordinal</code>, +<code>\ordinalstring</code> and <code>\numberstring</code> (and their +variants) will then be formatted in the currently +selected language. + +<P> +If the French language is selected, the French (France) version +will be used by default (e.g. soxiante-dix for 70). To +select the Swiss or Belgian variants (e.g. septente for 70) use: +<code>\fmtcountsetoptions{french=</code><I>dialect</I><code>}</code> +where <I>dialect</I> is either <TT>swiss</TT> or <TT>belgian</TT>. +You can also use this command to change the action of +<code>\ordinal</code>. +<code>\fmtcountsetoptions{abbrv=true}</code> to produce ordinals +of the form 2<SUP>e</SUP> or +<code>\fmtcountsetoptions{abbrv=false}</code> to produce ordinals +of the form 2<SUP>eme</SUP> (default). + +<P> +The <TT>french</TT> and <TT>abbrv</TT> settings only have an +effect if the French language has been defined. + +<P> +The male gender for all languages is used by default, however the +feminine or neuter forms can be obtained by passing <TT>f</TT> or +<TT>n</TT> as an optional argument to <code>\ordinal</code>, +<code>\ordinalnum</code> etc. For example: +<code>\numberstring{section}[f]</code>. Note that the optional argument +comes <I>after</I> the compulsory argument. If a gender is +not defined in a given language, the masculine version will +be used instead. + +<P> +Let me know if you find any spelling mistakes (has been known +to happen in English, let alone other languages I'm not so +familiar with.) If you want to add support for another language, +you will need to let me know how to form the numbers and ordinals +from 0 to 99999 in that language for each gender. + +<P> + +<H1><A NAME="SECTION00070000000000000000"> +Configuration File <TT>fmtcount.cfg</TT></A> +</H1> + +<P> +You can save your preferred default settings to a file called +<TT>fmtcount.cfg</TT>, and place it on the TeX path. These +settings will then be loaded by the <TT>fmtcount</TT> +package. + +<P> +Note that if you are using the <TT>datetime</TT> package, +the <TT>datetime.cfg</TT> configuration file will override +the <TT>fmtcount.cfg</TT> configuration file. +For example, if <TT>datetime.cfg</TT> has the line: +<PRE> +\renewcommand{\fmtord}[1]{\textsuperscript{\underline{#1}}} +</PRE> +and if <TT>fmtcount.cfg</TT> has the line: +<PRE> +\fmtcountsetoptions{fmtord=level} +</PRE> +then the former definition of <code>\fmtord</code> will take +precedence. + +<P> + +<H1><A NAME="SECTION00080000000000000000"> +LaTeX2HTML style</A> +</H1> + +<P> +The LaTeX2HTML style file <TT>fmtcount.perl</TT> is provided. +The following limitations apply: + +<P> + +<UL> +<LI><code>\padzeroes</code> only has an effect in the preamble. + +<P> +</LI> +<LI>The configuration file +<TT>fmtcount.cfg</TT> is currently ignored. (This is because +I can't work out the correct code to do this. If you +know how to do this, please let me know.) You can however +do: +<PRE> +\usepackage{fmtcount} +\html{\input{fmtcount.cfg}} +</PRE> +This, I agree, is an unpleasant cludge. + +<P> +</LI> +</UL> + +<P> + +<H1><A NAME="SECTION00090000000000000000"> +Acknowledgements</A> +</H1> + +<P> +I would like to thank my mother for the French and Portuguese +support and my Spanish dictionary for the Spanish support. +Thank you to K. H. Fricke for providing me with the German +translations. + +<P> + +<H1><A NAME="SECTION000100000000000000000"> +Troubleshooting</A> +</H1> + +<P> +There is a FAQ available at: <TT><A NAME="tex2html7" + HREF="http://theoval.cmp.uea.ac.uk/~nlct/latex/packages/faq/">http://theoval.cmp.uea.ac.uk/~nlct/latex/packages/faq/</A></TT>. + +<P> + +<H1><A NAME="SECTION000110000000000000000"> +Contact Details</A> +</H1> + Dr Nicola Talbot +<BR> +School of Computing Sciences +<BR> +University of East Anglia +<BR> +Norwich. NR4 7TJ. +<BR> +United Kingdom. +<BR> <TT><A NAME="tex2html8" + HREF="http://theoval.cmp.uea.ac.uk/~nlct/">http://theoval.cmp.uea.ac.uk/~nlct/</A></TT> +<BR><HR><H4>Footnotes</H4> +<DL> +<DT><A NAME="foot290">... +argument</A><A + HREF="manual.html#tex2html4"><SUP>1</SUP></A></DT> +<DD>See all the various postings to +<TT>comp.text.tex</TT> about <TT>\MakeUppercase</TT> + +</DD> +<DT><A NAME="foot244">... +1.1</A><A + HREF="manual.html#tex2html5"><SUP>2</SUP></A></DT> +<DD>Thanks to K. H. Fricke for supplying the information + +</DD> +<DT><A NAME="foot291">... defined</A><A + HREF="manual.html#tex2html6"><SUP>3</SUP></A></DT> +<DD>this +will be true if you have loaded <TT>babel</TT> + +</DD> +</DL> +<BR><HR> +<ADDRESS> +<A href=http://theoval.cmp.uea.ac.uk/~nlct/>Nicola L. C. Talbot</A>. +<A HREF=http://www.cmp.uea.ac.uk/>School of Computing Sciences</A>. +<A HREF=http://www.uea.ac.uk/>University of East Anglia.</A> +Last Modified: 2007-06-14 +</ADDRESS> +</BODY> +</HTML> |