See an example report here.
This repository is meant as a quickstart guide for NUS SOC students doing their Honors Year Project (HYP, aka FYP) final report in LaTeX.
It handles all the necessary styling and formatting of the final report so you can focus on your content.
*If you aren't going to use LaTeX (which is really awesome) for your final report, then you should ignore this entire repository. There is nothing here for you. (Except maybe how the final report should look like.)
You need to install LaTeX in order to build the final report.
This document should explain how to do it for you particular machine: http://latex-project.org/ftp.html
- Install LaTeX.
- Fork this repository.
- Edit content.
- Build report.
- Repeat as necessary.
Once you have LaTex installed, you simply run the following command in the root folder of project to build your report:
# Optional, if you want to do a "clean" build.
$ make clean
$ make report
This generates a report.pdf
file in the folder. Don't worry if you notice many other files being created. These are basically files created during the various intermediate steps of the build process.
This project is structured as follows:
.
|-- Makefile
|-- README.md
|-- contents
| |-- conclusion.tex
| |-- intro.tex
| `-- results.tex
|-- images
| |-- giraffe.jpg
| `-- squirrel.jpg
|-- report.bib
|-- report.tex
|-- socreport.bst
|-- socreport.cls
`-- tables
`-- example.tex
report.tex
:- This is the main file. It contains the meta information, abstracts, acknoledgements and all other includes.
- Edit this file with information about your project.
./contents/
:- This folder contains the text of the report. I included three example
.tex
files which are included in thereport.tex
. - Remove/Add files in this folder and update
report.tex
as necessary.
- This folder contains the text of the report. I included three example
./images/
:- This folder is used to contain all images.
- LaTex is also told to look for images here in
report.tex
./tables/
:- This folder contains the tables used in the report.
- Take a look at the example table included.
report.bib
:- This file contains the information for references in the report.
- Copy paste the BibTex citations and used them in the report using
\cite{}
. - An example in included in the introduction.
Not specific to this repository, but just some LaTeX stuff to help with writing and formatting your report. These should cover 90% of all your usage.
- Bold text:
\textbf{Bold} text
- italics:
\textit{italics}
monospace
text:\texttt{monospace} text
To cite something, use \cite{CITATION_REF}
where CITATION_REF
is the citation reference.
To cite something from Google Scholar:
- Find the paper
- Click
cite -> BibTex
- Copy the text shown and paste into
report.bib
This should look something like:
@book{lamport1986document,
title={Document Preparation System},
author={Lamport, Leslie and LaTEX, A},
year={1986},
publisher={Addison-Wesley Reading, MA}
}
- This first argument is the citation reference.
ShareLaTeX has a good intro guide here: https://www.sharelatex.com/learn/Mathematical_expressions.
For simple inlined symbols, wrap then in $
: eg.
An example code listing is included in the introduction. See: https://www.sharelatex.com/learn/Code_listing.
A intro guide for tables is: https://www.sharelatex.com/learn/Tables and for graphs is https://www.sharelatex.com/learn/Pgfplots_package.
I also recommend using a web editor to visually create any tables you want and using them to generate tex. Eg. http://www.tablesgenerator.com/), there are many others.
- This project uses the awesome
Makefile
courtesy of Chris Monson. You can read more about it here: http://www.bouncingchairs.net/oss/latex.html or find its source here: https://github.com/shiblon/latex-makefile. - The
socreport.bst
andsocreport.cls
files are courtesy of Prof Lee Wee Sun. It basically does all the magic in making the report look like it should. - The format of this repository is heavily inspired by Shawn who graciously shared his with me, saving me hours of my life.
gitignore
taken from https://github.com/github/gitignore- Giraffe Image taken from here
- Squirrel Image taken from here