Skip to main content
\( \newcommand{\lt}{<} \newcommand{\gt}{>} \newcommand{\amp}{&} \)

Section6Write your first document!

Although many of you will not be there yet, some of you will want to make your own first document. See this section; we will continue

Subsection6.1Use a template

Writing XML is tedious. There are many things to do to make it easier, including having an awesome text editor (which I do not). But the most important one is not to start from scratch!

For your first article, I recommend using the PTX minimal example, but for some even that one might be too maximal. If you want to make a really minimal example, please go directly to the most minimal document possible at the author's guide. I will do something in between here. See Example 8.1 for a little of the output.

Remark6.1

It's not bad practice to try to type this in verbatim without cut and paste; you'll want to exercise your typing chops in any case if you want to take on an PTX text.

<?xml version="1.0" encoding="UTF-8" ?>

 <mathbook>

    <article xml:id="minimal">
        <title>A Minimal Article</title>

        <frontmatter>

            <titlepage>
                <author>
                    <personname>Your Name</personname>
                    <institution>Your Place</institution>
                </author>
            </titlepage>

            <abstract>
                <p>An abstract.</p>
            </abstract>

        </frontmatter>

        <section xml:id="section-first">
            <title>A first (and only) section</title>

            <p>This paragraph has some inline math, a 
            Diophantine equation, <m>x^2 + y^2 = z^2</m>.  
            And some display math about infinite series: 
            <me>\sum_{n=1}^\infty\,\frac{1}{n^2} = 
            \frac{\pi^2}{6}.</me></p>
        </section>

    </article>

</mathbook>

We have two final notes. First, please let us know which of several possible topics would be of interest tomorrow, with the provided papers.

  • How to do common things like tables, links, or your idea in PTX

  • Creation of Sage or WeBWorK cells

  • Useful cross-referencing and naming

  • Bibliographies

  • More time to work on your project

  • Where PTX is picky (pickier than ), including lists

Second, if one of you has made enough progress that you'd be interested in sharing your “minimal” article, please let us know via email and we'd love to show it off at the beginning of next time!