Skip to main content

Getting Started with PreTeXt

Section Project 1: Build a Syllabus

This first project is deliberately plain. That is a feature, not a limitation. A syllabus is a good beginner project because it practices the structures that appear everywhere else in PreTeXt:
Create a new project called Calculus 1 Syllabus. Keep the finished model open in another tab: target syllabus.

Subsection Part 1. Build the Overall Structure

Checkpoint 4. Set up the section and subsection skeleton.

Start by shaping the document before you worry about wording. This makes every later paste easier because you already know where each chunk belongs.
(a)
Delete the starter content and paste a single <section> template into your project.
Solution. Target shape
<section>
  <title>Calculus I Syllabus</title>

  <subsection>
    <title>Course and Instructor Information</title>
  </subsection>

  <subsection>
    <title>Course Description</title>
  </subsection>

  <subsection>
    <title>Graded Work</title>
  </subsection>

  <subsection>
    <title>Course Schedule</title>
  </subsection>
</section>
(b)
Rebuild and confirm that the preview now shows one section with four empty subsections. If it does, your document structure is ready for content.

Subsection Part 2. Course and Instructor Information

Checkpoint 5. Turn plain text into a structured list.

(a)
Paste the block below into your first subsection, rebuild once, and notice that the content appears as one continuous paragraph.
<p>
  Course: ==CourseName==, ==Term==
  Instructor: ==YourName==
  Email: ==yourname@example.edu==
  Office: ==OfficeLocation==
  Office Hours: ==OfficeHours==
  Lecture: ==MeetingTime==, ==Room==
  Course Website: ==CanvasURL==
</p>
(b)
Convert that paragraph into a formatted list using:
Solution. If you want to compare
<subsection>
  <title>Course and Instructor Information</title>

  <p>
    <ul>
      <li>Course: ==CourseName==, ==Term==</li>
      <li>Instructor: ==YourName==</li>
      <li>Email: <c>==yourname@example.edu==</c></li>
      <li>Office: ==OfficeLocation==</li>
      <li>Office Hours: ==OfficeHours==</li>
      <li>Lecture: ==MeetingTime==, ==Room==</li>
      <li>Course Website: <url href="==URL==">Canvas</url></li>
    </ul>
  </p>

  <p>
    The best way to reach me outside of office hours is by email. I aim to reply within one business day.
  </p>
</subsection>

Subsection Part 3. Course Description

Checkpoint 6. Separate paragraphs and mark up the math.

(a)
Paste the following into the second subsection and rebuild. The prose will look dense and the math will render as plain text.
<p>
  Calculus I is a first course in differential calculus.
  We develop the concept of the limit from scratch, use it
  to give a precise definition of the derivative, and spend
  most of the semester learning to compute and apply
  derivatives. The course closes with an introduction to
  integration and the Fundamental Theorem of Calculus, which
  connects the two main ideas of the subject.

  By the end of the course, a successful student will be
  able to differentiate polynomials like
  p(x) = x^3 - 2x + 1, exponentials like e^x, logarithms
  like ln(x), and trigonometric functions like sin(x) and
  cos(x). They will also evaluate limits, apply the
  derivative to problems involving rates of change and
  optimization, and interpret the definite integral as a
  signed area.
</p>
(b)
Improve the structure by splitting the text into two <p> tags, wrapping every formula with <m>, and emphasizing the word β€œPrerequisites” somewhere in a final sentence with <em>.
Solution. One clean version
<subsection>
  <title>Course Description</title>

  <p>
    Calculus I is a first course in differential calculus.
    We develop the concept of the limit from scratch, use 
    it to give a precise definition of the derivative, 
    and spend most of the semester learning to compute 
    and apply derivatives. The course closes with an 
    introduction to integration and the Fundamental 
    Theorem of Calculus, which connects the two main 
    ideas of the subject.
  </p>

  <p>
    By the end of the course, a successful student will 
    be able to differentiate polynomials like 
    <m>p(x)=x^3-2x+1</m>, exponentials like <m>e^x</m>, 
    logarithms like <m>\ln(x)</m>, and trigonometric 
    functions like <m>\sin(x)</m> and <m>\cos(x)</m>. 
    They will also evaluate limits, apply the derivative 
    to problems involving rates of change and 
    optimization, and interpret the definite integral as 
    a signed area.
  </p>

</subsection>

Subsection Part 4. Graded Work

Checkpoint 7. Use a description list and a table together.

(a)
Paste the block below into the third subsection. Rebuild once so you can see why plain text is not the right structure for policy information.
<p>
  Homework: 20 percent.
  Due Sundays at 11:59 pm on Canvas. Collaborate
  freely, but write solutions in your own words.
  Late work accepted up to 48 hours late at a 20
  percent penalty; lowest two scores dropped.

  Quizzes: 10 percent.
  Short biweekly quizzes covering the recent
  material.

  Midterm 1: 20 percent.
  Closed book, closed notes, one handwritten
  reference sheet permitted.

  Midterm 2: 20 percent.
  Same format as Midterm 1.

  Final exam: 30 percent.
  Cumulative. Time and room set by the registrar.

  Grade cutoffs:
  A at 90 percent or above, B at 80 percent or above,
  C at 70 percent or above, D at 60 percent or above.
  Cutoffs may be lowered at the end of the term but
  will never be raised.
</p>
(c)
Add a summary table above the description list using the <tabular>, <row>, and <cell> templates. Two columns are enough: the component and the percentage.
Solution. Checkpoint
<subsection>
  <title>Graded Work</title>

  <tabular>
    <row>
      <cell>Homework</cell>
      <cell>20%</cell>
    </row>
    <row>
      <cell>Quizzes</cell>
      <cell>10%</cell>
    </row>
    <row>
      <cell>Midterm 1</cell>
      <cell>20%</cell>
    </row>
    <row>
      <cell>Midterm 2</cell>
      <cell>20%</cell>
    </row>
    <row>
      <cell>Final Exam</cell>
      <cell>30%</cell>
    </row>
  </tabular>

  <p>
    <dl>
      <li>
        <title>Homework</title>
        <p>
          Due Sundays at 11:59 pm on Canvas. Collaborate 
          freely, but write solutions in your own words. 
          Late work accepted up to 48 hours late at a 20 
          percent penalty; lowest two scores dropped.
        </p>
      </li>
      <li>
        <title>Quizzes</title>
        <p>
          Short biweekly quizzes covering the recent
          material.
        </p>
      </li>
      <li>
        <title>Midterm 1</title>
        <p>
          Closed book, closed notes, one handwritten 
          reference sheet permitted.
        </p>
      </li>
      <li>
        <title>Midterm 2</title>
        <p>Same format as Midterm 1.</p>
      </li>
      <li>
        <title>Final Exam</title>
        <p>
          Cumulative. Time and room set by the registrar.
        </p>
      </li>
      <li>
        <title>Grade Cutoffs</title>
        <p>
          At most A at 90 percent, B at 80, C at 70, 
          D at 60. Cutoffs may be lowered at the end 
          of the term but will never be raised.
        </p>
      </li>
    </dl>
  </p>
</subsection>

Subsection Part 5. Course Schedule

Checkpoint 8. Style a longer table.

This final subsection turns a large block of schedule data into a readable table. The syntax is a little verbose, so work slowly and rebuild after each small edit.
(a)
Paste this starter table into your last subsection.
<tabular>
  <row>
    <cell><p>Week</p></cell><cell><p>Dates</p></cell>
      <cell><p>Topics</p></cell>
      <cell><p>Reading</p></cell>
    </row>
    <row>
      <cell>1</cell><cell>Aug 25-Aug 29</cell>
      <cell>Average/instantaneous velocity</cell>
      <cell>1.1</cell>
    </row>
    <row>
      <cell>2</cell><cell>Sep 1-Sep 5</cell>
      <cell>The limit of a function; limit laws</cell>
      <cell>1.2</cell>
    </row>
    <row>
      <cell>3</cell><cell>Sep 8-Sep 12</cell>
      <cell>Continuity; limits at infinity</cell>
      <cell>1.3, 1.4</cell>
    </row>
    <row>
      <cell>4</cell><cell>Sep 15-Sep 19</cell>
      <cell>Definition of the derivative</cell>
      <cell>2.1, 2.2</cell>
    </row>
    <row>
      <cell>5</cell><cell>Sep 22-Sep 26</cell>
      <cell><alert>Midterm 1</alert></cell>
      <cell></cell>
    </row>
    <row>
      <cell>6</cell><cell>Sep 29-Oct 3</cell>
      <cell>Product/quotient rules</cell>
      <cell>2.4, 2.5</cell>
    </row>
    <row>
      <cell>7</cell><cell>Oct 6-Oct 10</cell>
      <cell>The chain rule</cell>
      <cell>2.6</cell>
    </row>
    <row>
      <cell>8</cell><cell>Oct 13-Oct 17</cell>
      <cell>Implicit differentiation</cell>
      <cell>2.7, 2.8</cell>
    </row>
    <row>
      <cell>9</cell><cell>Oct 20-Oct 24</cell>
      <cell>Related rates; linear approximation</cell>
      <cell>3.1, 3.2</cell>
    </row>
    <row>
      <cell>10</cell><cell>Oct 27-Oct 31</cell>
      <cell><alert>Midterm 2</alert></cell>
      <cell></cell>
    </row>
    <row>
      <cell>11</cell><cell>Nov 3-Nov 7</cell>
      <cell>Increasing/decreasing; Concavity</cell>
      <cell>3.4, 3.5</cell>
    </row>
    <row>
      <cell>12</cell><cell>Nov 10-Nov 14</cell>
      <cell>Optimization</cell>
      <cell>3.6</cell>
    </row>
    <row>
      <cell>13</cell><cell>Nov 17-Nov 21</cell>
      <cell>L'Hopital's rule; antiderivatives</cell>
      <cell>3.7, 4.1</cell>
    </row>
    <row>
      <cell>14</cell><cell>Dec 1-Dec 5</cell>
      <cell>The definite integral; Riemann sums</cell>
      <cell>4.2, 4.3</cell>
    </row>
    <row>
      <cell>15</cell><cell>Dec 8-Dec 12</cell>
      <cell>Fundamental Theorem of Calculus; review</cell>
      <cell>4.4</cell>
    </row>
    <row>
      <cell>16</cell><cell>Dec 16</cell>
      <cell><alert>Final Exam, 8:00-10:00 am</alert></cell>
      <cell>Cumulative</cell>
    </row>
</tabular>
(b)
Apply the following table improvements, rebuilding after each one:
  1. Mark the first row as a header with header="yes".
  2. Add borders on the <tabular>.
  3. Add four <col/> tags for width and alignment.
  4. Wrap the exam weeks in <alert>.
Solution. Styled version
<subsection xml:id="sec-schedule">
  <title>Course Schedule</title>

  <p>
    Section numbers refer to <em>Active Calculus</em>. 
    Topic coverage may shift by a class or two depending 
    on pacing.
  </p>

  <tabular 
    top="minor" bottom="minor" left="minor" right="minor">
    <col width="9%" halign="center"/>
    <col width="40%" halign="center"/>
    <col width="36%"/>
    <col width="15%"/>
    <row header="yes">
      <cell><p>Week</p></cell><cell><p>Dates</p></cell>
      <cell><p>Topics</p></cell>
      <cell><p>Reading</p></cell>
    </row>
    <row>
      <cell>1</cell><cell>Aug 25-Aug 29</cell>
      <cell>Average/instantaneous velocity</cell>
      <cell>1.1</cell>
    </row>
    <row>
      <cell>2</cell><cell>Sep 1-Sep 5</cell>
      <cell>The limit of a function; limit laws</cell>
      <cell>1.2</cell>
    </row>
    <row>
      <cell>3</cell><cell>Sep 8-Sep 12</cell>
      <cell>Continuity; limits at infinity</cell>
      <cell>1.3, 1.4</cell>
    </row>
    <row>
      <cell>4</cell><cell>Sep 15-Sep 19</cell>
      <cell>Definition of the derivative</cell>
      <cell>2.1, 2.2</cell>
    </row>
    <row>
      <cell>5</cell><cell>Sep 22-Sep 26</cell>
      <cell><alert>Midterm 1</alert></cell>
      <cell></cell>
    </row>
    <row>
      <cell>6</cell><cell>Sep 29-Oct 3</cell>
      <cell>Product/quotient rules</cell>
      <cell>2.4, 2.5</cell>
    </row>
    <row>
      <cell>7</cell><cell>Oct 6-Oct 10</cell>
      <cell>The chain rule</cell>
      <cell>2.6</cell>
    </row>
    <row>
      <cell>8</cell><cell>Oct 13-Oct 17</cell>
      <cell>Implicit differentiation</cell>
      <cell>2.7, 2.8</cell>
    </row>
    <row>
      <cell>9</cell><cell>Oct 20-Oct 24</cell>
      <cell>Related rates; linear approximation</cell>
      <cell>3.1, 3.2</cell>
    </row>
    <row>
      <cell>10</cell><cell>Oct 27-Oct 31</cell>
      <cell><alert>Midterm 2</alert></cell>
      <cell></cell>
    </row>
    <row>
      <cell>11</cell><cell>Nov 3-Nov 7</cell>
      <cell>Increasing/decreasing; Concavity</cell>
      <cell>3.4, 3.5</cell>
    </row>
    <row>
      <cell>12</cell><cell>Nov 10-Nov 14</cell>
      <cell>Optimization</cell>
      <cell>3.6</cell>
    </row>
    <row>
      <cell>13</cell><cell>Nov 17-Nov 21</cell>
      <cell>L'Hopital's rule; antiderivatives</cell>
      <cell>3.7, 4.1</cell>
    </row>
    <row>
      <cell>14</cell><cell>Dec 1-Dec 5</cell>
      <cell>The definite integral; Riemann sums</cell>
      <cell>4.2, 4.3</cell>
    </row>
    <row>
      <cell>15</cell><cell>Dec 8-Dec 12</cell>
      <cell>Fundamental Theorem of Calculus; review</cell>
      <cell>4.4</cell>
    </row>
    <row>
      <cell>16</cell><cell>Dec 16</cell>
      <cell><alert>Final Exam, 8:00-10:00 am</alert></cell>
      <cell>Cumulative</cell>
    </row>
  </tabular>
</subsection>

What this project taught you.

You have now used the most common beginner structures in PreTeXt. If you can build this syllabus from scratch, you are ready for short narrative lessons and handouts.