Editing CommunityData:TeX
From CommunityData
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
In order to write LaTeX documents, there are two main options. The first is to do everything in Overleaf. The second option, which is explained | In order to write LaTeX documents, there are two main options. The first is to do everything in Overleaf. The second option, which is explained in this document, is to install software on your local machine which will compile LaTeX documents. This document explains how to use our lab-created templates. Using other templates may require other steps. | ||
== Installing Dependencies == | |||
== | |||
=== Debian/Ubuntu Installation Instructions === | === Debian/Ubuntu Installation Instructions === | ||
Line 88: | Line 33: | ||
texlua install-getnonfreefonts | texlua install-getnonfreefonts | ||
sudo getnonfreefonts-sys garamond | sudo getnonfreefonts-sys garamond | ||
== Getting/Installing Templates == | |||
You can find the latest version of the templates [https://code.communitydata.science/cdsc_tex.git here]. | |||
To clone the public repository, you can do: | |||
git clone git://code.communitydata.science/cdsc_tex | |||
If you can clone them into the directory <code>~/tex/</code> (e.g., by doing <code>mkdir ~/tex; cd ~/tex</code> before running the clone command above) it will make things a bit easier. | |||
This code includes a bunch of bash scripts which are used to quickly create a new project. If you want, you can copy the files into your path (e.g., <code>ln -s ~/tex/cdsc_tex/new* ~/bin/</code>); this will allow you to run, for example, <code>new_knitr_document documentname</code> to create a new knitr document from the template. | |||
== Using the Templates == | |||
The templates themselves use the [http://texdoc.net/texmf-dist/doc/latex/memoir/memman.pdf LaTeX Memoir Class] (warning that link is a ~1000 page PDF and the documentation). There are three styles that come with it and two basic layouts that are defined. To switch between them, you just edit the following line: | |||
\chapterstyle{article-2} | |||
The first style <code>article-1</code> is the most conservative. <code>article-2</code> is great for papers ([https://mako.cc/academic/shaw_hill-laboratories_of_oligarchy-DRAFT.pdf a perhaps dated example]). The third style <code>article-3</code> is more for shorter pieces and memos ([https://mako.cc/academic/bmh-research_statement.pdf a perhaps dated example]). If you want to use the style, you might want to consider switching the pagestyle from <code>mako-mem</code> to <code>memo</code> by editing the following line: | |||
\pagestyle{mako-mem} | |||
== Sending Patches == | |||
If you want to send patches, these currently should be sent over email to mako. Details on how to do this with the <code>git format-patch</code> command are online here: https://code.communitydata.science/ |