ProjectsPortfolio
Home Assignments Lecture Blog Resources Discussion Group
Overview
You are to create a report that presents a portfolio of all of your work over the semester.
For each assignment, the portfolio should include:
- The PS number and title of the assignment
- A discussion of the assignment itself and what you accomplished.
- A discussion of one or more key algorithms, data structures, or OO designs that were central to the assignment.
- A discussion of what you learned in the particular assignment.
- Evidence that the code ran -- e.g., screenshot, console log, text output, results of running tests.
- If you didn't complete any part of any assignment, the things that you didn't do, or didn't get working.
- Nicely-formatted source code listings for all source code comprising the assignment.
Format
The document must be a delivered as a single PDF file.
The document should have the following sections:
- Cover page and table of contents. This should be a single page that has your name on it, the date, and a listing of each assignment. See Attach:pp-cover.odt and Attach:pp-cover.pdf as an example.
- For each assignment, the things above, in the order listed above.
Do NOT put all the code at the end of the document. Instead, put the files associated with each problem set immediately after the narrative for that PS.
Document Production Tools
enscript
I advise you to use the Unix utility enscript
to make formatted versions of your source code files. The -C
option adds line numbers (which you can then use in your narrative to refer to specific sections). I like the --margins=50:50:50:50
to set up the margins nicely. Use the -o
option to direct the output to a file.
This will produce a PostScript (ps
) output file. Then, use ps2pdf
to make a PDF file.
E.g., for the GuitarHeroLite.cpp
starter file, use these commands:
enscript -C --margins=50:50:50:50 GuitarHeroLite.cpp -o GuitarHeroLite.cpp.ps
ps2pdf GuitarHeroLite.cpp.ps
and then you will have a file named GuitarHeroLite.cpp.pdf
.
A word processor that outputs PDFs
Use any word processor you like and save individual assignment narratives as PDF files.
pdftk
Use the Unix utility pdftk
to assemble separate PDFs into a single one.
If you name your files like this:
00_narrative.pdf
01_code1.pdf
02_code2.pdf
Then you can assemble these using:
pdftk ??_*.pdf cat output section_name.pdf
Create numbered sections for each assignment, then assemble them into the whole PDF.
Turn in
Turn in complete portfolio as a single PDF file. Make sure to include your real name in the file name.
submit fredm 204-pp filename_with_your_name.pdf