rrwen / cookiecutter-latex-ryerson

Personal template for LaTeX documents following thesis, major research papers, and dissertation submission guidelines by the Yeates School of Graduate Studies at Ryerson University

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

cookiecutter-latex-ryerson

Richard Wen
rrwen.dev@gmail.com

Personal template for LaTeX documents following thesis, major research papers, and dissertation submission guidelines by the Yeates School of Graduate Studies at Ryerson University.

Build Status GitHub license

Install

  1. Install Python
  2. Install cookiecutter with pip
  3. Install TeX Live or Miktex
  4. Install git
  5. Install perl
  6. Add TeX Live path or Miktex path to system or environmental paths
pip install cookiecutter

Usage

  1. Create a template using cookiecutter with a user input prompt
  2. Change directory to the project_name folder (based on user input) with cd
  3. Modify LaTeX files inside front_matter, back_matter, and main_body folders
  4. Create a PDF file from the LaTex files with make.bat or make.sh
  5. Re-create PDF file as needed with Step 4

In windows:

cookiecutter gh:rrwen/cookiecutter-latex-ryerson
cd project_name
make

In Linux/Mac:

cookiecutter gh:rrwen/cookiecutter-latex-ryerson
cd project_name
chmod +x make.sh
./make.sh

See Implementation for more details.

Github Repository

You may wish to also create a Github repository for your paper:

  1. Ensure git is installed
  2. Change directory to the project_name folder
  3. Initialize the repository with git init
  4. Add the template files to commit with git add
  5. Sign up for a Github Account if you have not already
  6. Create an empty Github repository with the same name as project_name
  7. Add the empty remote repository from Step 6 with git remote
  8. (Optional) Pull any changes if the Github repository is not empty with git pull
  9. Push the commit from Step 4 to your created Github repository with git push
  10. View your Github repository at https://github.com/<github_user>/<project_name>
cd project_name
git init
git add .
git commit -a -m "Initial commit"
git remote add origin https://github.com/<github_user>/<project_name>.git
git pull origin master --allow-unrelated-histories
git push -u origin master

Developer Notes

Implementation

This code creates folders and files for cookiecutter templates.

        cookiecutter              <-- template tool
             |
      cookiecutter.json           <-- template inputs
             |
{{cookiecutter.project_name}}    <-- generated template

The following files will be created inside a folder with the same name as the project_name input:

File Description
back_matter/appendices.tex a LaTeX file containing the appendices content
back_matter/bibliography.bib a BibTeX file for storing references
back_matter/bibliography.tex a LaTeX file containing the automatic bibliography
back_matter/glossary.tex a LaTeX file containing the glossary content
back_matter/index.tex a LaTeX file containing the index content
code/helloworld.py a sample Python file to demonstrate code listings
front_matter/abstract.tex a LaTeX file containing the abstract content
front_matter/acknowledgements.tex a LaTeX file containing the acknowledgements content
front_matter/authors_declaration.tex a LaTeX file containing the declaration content
front_matter/dedication.tex a LaTeX file containing the dedication content
front_matter/list_of_appendices.tex a LaTeX file containing the automatic list of appendices using commands in custom.tex
front_matter/list_of_figures.tex a LaTeX file containing the automatic list of figures
front_matter/list_of_tables.tex a LaTeX file containing the automatic list of tables
front_matter/table_of_contents.tex a LaTeX file containing the automatic table of contents
front_matter/title_page.tex a LaTeX file containing the title page
figures/ folder for figure image files (.pdf, .png, .jpg)
figures/graphic.pdf sample figure image in .pdf format
main_body/chapter01_background.tex a LaTeX file containing the background content
main_body/chapter02_methods.tex a LaTeX file containing the method content
main_body/chapter03_results.tex a LaTeX file containing the results content
main_body/chapter04_discussion.tex a LaTeX file containing the discussion content
main_body/chapter05_conclusion.tex a LaTeX file containing the conclusion content
main_body/introduction.tex a LaTeX file containing the introduction content
.gitignore a gitignore file for manually untracking files
.travis.yml a Travis CI file for automatic testing
{{cookiecutter.vars.tex_file}}.tex the main LaTeX file for producing the PDF (named lastnameYear_project_name.tex)
LICENSE MIT license file automatically created from github
make.bat a Batch file for creating the PDF in Windows
make.sh a Shell Script for creating the PDF in Linux/Mac
packages.tex a file containing the required LaTeX packages used in the template
README.md a readme Markdown file with header section

About

Personal template for LaTeX documents following thesis, major research papers, and dissertation submission guidelines by the Yeates School of Graduate Studies at Ryerson University

License:MIT License


Languages

Language:TeX 92.0%Language:Shell 4.1%Language:Batchfile 3.6%Language:Python 0.3%