Back to Main page

# How do I use the resources on this site?

You may use as many of the pre-compiled topical worksheets as you need to teach any section of your course, or you may create your own custom worksheets from question files contained on this website.

Select as many or as few of the topical worksheets as you need to teach any section of your course, and give those worksheets directly to your students. If any of the topical worksheets contain questions that are beyond the scope of your intended instruction, just tell your students to skip those questions. The advanced students will probably go ahead and answer them anyway.

The alternative to this approach is to build your own custom worksheets from the question files contained on this website. This, however, requires some computer skills, especially in the area of writing "scripts" to direct the worksheet compilation process.

At root, this website is nothing more than a large "bank" of questions, plus computer "scripts" necessary to arrange them into complete worksheets. Each question consists of a single plain-text computer file, along with any necessary graphics files for illustrations and pictures. Using the UNIX programs cat and sed, these individual question files are separated into Question, Answer, and Notes sections, then assembled into a single worksheet file and compiled. Then, the a very powerful text processing program named TeX is used, along with two other UNIX utilities (dvips and ps2pdf), to generate a final PDF-format output file. The details of worksheet compilation are given in this text file.

All of these utility programs are available for use on Microsoft Windows systems, though some of the syntax used in the scripts will have to be altered in order for Microsoft operating systems to understand them. I use Linux exclusively for my work (running the "Bash" command shell), where all these programs run natively. Another option for Microsoft users is to download the free UNIX environment Cygwin, in which the UNIX scripts available at this website will execute as they would on a UNIX system (running the "Bash" shell).

The pre-compiled worksheets I have on this website are primarily given to showcase the individual questions. You do not have to use the worksheets as shown here. To make your own worksheet, simply write which questions you want to have in your worksheet, in the order that you want them shown. Each question is identified by a unique file number ("file 00017", for instance), for your identification purposes. Then, write a "sequence" script commanding the cat utility to arrange the files together into a large file named "all", and save it with the name you wish the final worksheet file to have, plus the extension ".seq" (for example, if I wanted the worksheet to have the name TEST, I would name the sequence file TEST.seq). Be sure to set the executable permission bit on this file, as the .seq file is an executable script!

Shown here is a listing of a sample sequence script file's contents:

# "Concatenating" all selected questions/answers/notes into a single TeX file.
# This is where you specify the questions you want included in your worksheet, in the
# order you want them to appear.
cat \
00009.tex \
00017.tex \
00011.tex \
00021.tex \
00028.tex \
> all.tex


If you are new to writing scripts, it is highly recommended for you to take an existing script file (such as the atomic.seq script which controls the assemblage of questions in the stock "Atomic structure" worksheet found at this site) and modify it to your liking rather than write a new file. I have also provided a "blank" sequence file named core.seq precisely for this purpose. Copying an existing sequence file through the OS (by issuing a "copy" command) and then modifying it also means the executable permission will already be properly set, without you having to manually set it as you would if you wrote a sequence script from scratch.

You will also have to create a TeX file for the cover page of your worksheet, naming it the same as your sequence file, except with a different filename extension: .tex. For example, if you name your sequence file TEST.seq, you should name the cover page file TEST.tex. Here is a listing of a sample cover page file's contents:

\centerline{\bf My simple worksheet} \bigskip

All problems comprising this worksheet are licensed under the
copyrighted by their respective authors.  To view a copy of
or send a letter to Creative Commons, 559 Nathan Abbott Way,
Stanford, California 94305, USA.  The terms and conditions of
modification of all licensed works by the general public.

The worksheet itself, as a derivative entity, is copyright
Metropolis Community College, Jane Doe (instructor), 2003.

\bigskip

Blah Blah Blah


Again, it is recommended for beginners to just modify an existing cover page file (such as atomic.tex) rather than create a brand-new file from scratch.

Once you have the necessary scripts, utilities, and selected question files downloaded to your computer's hard drive, simply type the command "make" at the top directory for the project to compile any and all uncompiled worksheets (including the new worksheet you made named TEST). The eventual result will be a finished worksheet in PDF format (TEST.pdf), located in the output subdirectory.

Note that the limited rights secured by the Creative Commons Attribution License for the constituent problems allow anyone to bundle these "free" problems into custom worksheets and make those worksheets fully copyrighted, derivative works. Thus, in compiling your own worksheet you are legally permitted to protect it under full copyright, adding whatever you wish to it (including full answers which students shouldn't have access to) and only publishing those parts of it you desire. The only condition you are bound to is that of acknowledging the original authorship of the individual questions. In other words, while the worksheet is your intellectual property, the individual questions are not.

To download all the worksheet "source" files in one step, just click here. The file you will receive is in the "tar" format, which popular archiving programs such as WinZip will be able to unpack. Of course, you will still need to download and install all the necessary utilities for compiling these source files (including Cygwin if you are using a Microsoft Windows computer system).

Back to Main page