Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/kostafey/sphinx-frontend

Launch build process for rst documents via sphinx.
https://github.com/kostafey/sphinx-frontend

Last synced: 3 months ago
JSON representation

Launch build process for rst documents via sphinx.

Awesome Lists containing this project

README

        

# sphinx-frontend

sphinx-frontend provides a simple way to find closest
[Sphinx](http://sphinx-doc.org/) configuration file (`conf.py`) and run the
Sphinx.

## Installation

Add MELPA (if not yet) to your `package-archives` list:

```lisp
(require 'package)
(add-to-list 'package-archives
'("melpa" . "https://melpa.org/packages/"))
(package-initialize)
```

Then you can install `sphinx-frontend` with the following command:

M-x package-install [RET] sphinx-frontend [RET]

Load sphinx-frontend:

```lisp
(require 'sphinx-frontend)
```

## Usage

List of interactive commands (added or replaced in `rst-mode-map`):

Key | Command | Description
------------------|-----------------------|------------------------------------------------------
C-c h | `sphinx-build-html` | Compile rst files to html via sphinx
C-c l | `sphinx-build-latex` | Compile rst files to latex
C-c p | `sphinx-run-pdflatex` | Ad-hoc call pdflatex for LaTeX-builded documentation
| `sphinx-clean-html` | Remove `sphinx-output-dir-html` dir
| `sphinx-clean-pdf` | Remove `sphinx-output-dir-pdf` dir

## License

Copyright © 2012-2016 kostafey

Distributed under the General Public License 2.0+