aboutsummaryrefslogtreecommitdiff
path: root/report2/README.md
diff options
context:
space:
mode:
authornunzip <np_scarh@e4-pattern-vm.europe-west4-a.c.electric-orbit-223819.internal>2018-12-05 18:52:27 +0000
committernunzip <np_scarh@e4-pattern-vm.europe-west4-a.c.electric-orbit-223819.internal>2018-12-05 18:52:27 +0000
commit60189ef2705ea441cadff4afd63fe396edb6550a (patch)
treec011ef17475ff5f89e4a81f28b2d75fcadbc4bb6 /report2/README.md
parent48ac66ef7f26a4d503e5850af1ee2ad345fd6dc7 (diff)
downloadvz215_np1915-60189ef2705ea441cadff4afd63fe396edb6550a.tar.gz
vz215_np1915-60189ef2705ea441cadff4afd63fe396edb6550a.tar.bz2
vz215_np1915-60189ef2705ea441cadff4afd63fe396edb6550a.zip
Set up report structure
Diffstat (limited to 'report2/README.md')
-rw-r--r--report2/README.md52
1 files changed, 52 insertions, 0 deletions
diff --git a/report2/README.md b/report2/README.md
new file mode 100644
index 0000000..1313d40
--- /dev/null
+++ b/report2/README.md
@@ -0,0 +1,52 @@
+# IEEE Paper Template for Pandoc
+
+[![Build Status](https://travis-ci.org/stsewd/ieee-pandoc-template.svg?branch=master)](https://travis-ci.org/stsewd/ieee-pandoc-template)
+
+## Requirements
+
+- [Pandoc](http://pandoc.org/)
+- [Texlive](https://www.tug.org/texlive/)
+
+### Ubuntu
+
+```sh
+sudo apt update
+sudo apt install pandoc pandoc-citeproc texlive-full
+```
+
+### Fedora
+
+```sh
+sudo dnf install pandoc pandoc-citeproc texlive-scheme-full
+```
+
+## Quickly Usage
+
+- Clone or download this repo.
+- Put all your paper content in `paper.md`.
+- Change the title and author in `metadata.yaml`.
+- Run `make` in a terminal.
+- The pdf will be on `build/paper.pdf`.
+
+## Files
+
+| File | Description |
+|--------------------|-----------------------------------------------------------------------------------------------------------------------------------|
+| `metadata.yml` | On this file put all your metadata (author, title, abstract, etc) that will be use for rendering the final pdf. |
+| `paper.md` | Here you put all your paper content, if you wish, you could put your content on separate files, but you must edit the `makefile`. |
+| `bibliography.bib` | Here put all the bibliography that is used in the paper. |
+| `bibliography.csl` | This file is for specify to pandoc how to display the cites (ieee format). |
+| `template.latex` | It is used to tell pandoc how to render the paper using the metadata and content of your paper. |
+| `makefile` | It is used to compile the pdf, usually the default options are fine. |
+| `build/` | On this directory will be final pdf. Make sure to add this to your `.gitignore` file if you are using git. |
+
+## Recommended Tools
+
+### Editors
+
+- [Vim](http://vim.org)/[Neovim](https://neovim.io/) + [vim-pandoc extension](https://github.com/vim-pandoc/vim-pandoc)
+- [Atom](http://atom.io) + [language-pfm extension](https://atom.io/packages/language-pfm) + [autocomplete-bibtex extension](https://atom.io/packages/autocomplete-bibtex)
+
+### Bibliography manager
+
+- [Zotero](https://www.zotero.org/) + [Better Bibtext extension](https://github.com/retorquere/zotero-better-bibtex)