Skip to content
Snippets Groups Projects
README.md 2.33 KiB
Newer Older
Santos Gallegos's avatar
Santos Gallegos committed
# IEEE Paper Template for Pandoc

Santos Gallegos's avatar
Santos Gallegos committed
[![Build Status](https://travis-ci.org/stsewd/ieee-pandoc-template.svg?branch=master)](https://travis-ci.org/stsewd/ieee-pandoc-template)

Santos Gallegos's avatar
Santos Gallegos committed
## Requirements

- [Pandoc](http://pandoc.org/)
Santos Gallegos's avatar
Santos Gallegos committed
- [Texlive](https://www.tug.org/texlive/) (recommended)
Santos Gallegos's avatar
Santos Gallegos committed

## Quickly Usage

Put all your paper content on `paper.md`, change the title and author
on `metadata.yaml` and run `make pdf`. The pdf will be on `build/paper.pdf`.

## Usage

### Files

Santos Gallegos's avatar
Santos Gallegos committed
| 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.                                                      |
Santos Gallegos's avatar
Santos Gallegos committed

Santos Gallegos's avatar
Santos Gallegos committed
### Compiling

Run `make` on a terminal and the pdf will be on `build/paper.pdf`.

## Recommended Tools

### Editors

Santos Gallegos's avatar
Santos Gallegos committed
- [Vim](http://vim.org)/[NVim](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)
Santos Gallegos's avatar
Santos Gallegos committed

### Bibliography manager
- [Zotero](https://www.zotero.org/) + [Better Bibtext extension](https://github.com/retorquere/zotero-better-bibtex)
Santos Gallegos's avatar
Santos Gallegos committed