Hi,

please find below a proposal for a XML-FAQ format. I hope it covers
all suggestions Hans and Henning have made in the last discussions.
More suggestions are welcome.

notes:
- the label= in <contextfaq> can be used for cross-references
- the id= in <author> is a reference to the author database as 
  requested by Henning
- the modified= in <revision> should be used to highlight updated
  FAQs in a new ConTeXt-FAQ issue
- there is only one key for sectioning, since IMO the "application"
  should know where this section (specified by id=) is in the
  document tree. This should allow easy reordering of the FAQ
- and a question: what is the better solution for different types
  of parenthesis in TeX code; the 1st or the 2nd <texcode> block? 

Tsch� Jens.

<contextfaq label="jum-0001">
        <head>
                <author id="jum"/>
                <revision published="2002-10-27" modified="2002-10-27"/>
                <keywords>
                        <entry key="clipping">clipping</entry>
                        <entry key="clip">
                                <tex>clip</tex>
                        </entry>
                        <entry key="externalfigure">
                                <tex>externalfigure</tex>
                        </entry>
                        <entry key="figure">figure</entry>
                </keywords>
                <section id="graphics-manipulation"/> 
        </head>
        <body>
                <question>
                Is it possible to show only a part of an external  figure?
                </question>
                <answer>
                <p> The command <tex>clip</tex> allows to show only a part of a figure.
                You can either split the figure in rows and columns in order to show 
one
                of the resulting segments or you can specify a viewport directly.</p>
                <p>The following code tiles the figure in 3 columns and 2 rows and 
shows
                the segment in row 1 and column 2:</p>
                <texcode>
                        <macro>clip</macro>
                                <sqbracket>nx=3,ny=2,x=2,y=1</sqbracket>
                                <braces>
                                        <macro>externalfigure</macro>
                                        <sqbracket>yourfigure</sqbracket>
                                </braces>
                </texcode>
                <p> In order to specify the visible part directly you can use:</p>
                <texcode>
                        <macro>clip</macro>
                                [hoffset=3cm,voffset=2cm,width=4cm,height=3cm]
                                {<macro>externalfigure</macro>[yourfigure]}
                </texcode>
                </answer>
        </body>
</contextfaq> 
_______________________________________________
ntg-context mailing list
[EMAIL PROTECTED]
http://ref.ntg.nl/mailman/listinfo/ntg-context

Reply via email to