Metadata-Version: 2.1
Name: ntdocutils-theme-mdl
Version: 1.0.0
Summary: NtDocutils is a theme manager for Docutils.
Home-page: https://nt.web.ve/en/projects/ntdocutils-theme-mdl
Author: Miguel Angel Rivera Notararigo
Author-email: ntrrgx@gmail.com
License: MIT
Keywords: docutils restructuredtext docutils-theme-manager docutils-themes documentation
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Other Audience
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Documentation
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Text Processing
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
Requires-Dist: NtDocutils (>=1.0.0)

[![pypi](https://img.shields.io/pypi/v/ntdocutils-theme-mdl.svg)](https://pypi.python.org/pypi/ntdocutils-theme-mdl)

## Install

This theme requires:

* Python >= 3.4
* NtDocutils >= 1.0.0 (auto installed)

### From PyPI

```shell-session
# pip install ntdocutils-theme-mdl==0.1.0
```

### From source

```shell-session
$ wget -c 'https://github.com/ntrrg/ntdocutils-theme-mdl/archive/v0.1.0.tar.gz'
```

```shell-session
$ tar -xvf ntdocutils-theme-mdl-0.1.0.tar.gz
```

```shell-session
$ cd ntdocutils-theme-mdl-0.1.0
```

```shell-session
# python3 setup.py
```

## Usage

Basically, you have to do two things:

1\. Create a `.rst` file:

`example.rst`:

```rest
==========
My Article
==========

:Author: Vultur Gryphus
:Contact: info@vultur.org.ve

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad
minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip
ex ea commodo consequat. Duis aute irure dolor in reprehenderit in
voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident, sunt in culpa qui officia
deserunt mollit anim id est laborum.
```

2\. Process your file:

```shell-session
$ ntdocutils -T mdl example.rst example.html
```

And that's it, you already have a HTML file.

![Example](screenshots/example.png)

Also see the [site](https://ntrrg.github.io/ntdocutils-theme-mdl/).

## Uninstall

Should be enough with this:

```shell-session
# pip uninstall -y ntdocutils-theme-mdl
```

## Acknowledgment

Working on this project I use/used:

* [Debian](https://www.debian.org/)

* [XFCE](https://xfce.org/)

* [Sublime Text 3](https://www.sublimetext.com/3)

* [Chrome](https://www.google.com/chrome/browser/desktop/index.html)

* [Terminator](https://gnometerminator.blogspot.com/p/introduction.html)

* [Zsh](http://www.zsh.org/)

* [Git](https://git-scm.com/)

* [EditorConfig](http://editorconfig.org/)

* [Github](https://github.com)

* [Inkscape](https://inkscape.org/en/)

* [GIMP](https://www.gimp.org/)

* [Material Icons](https://material.io/icons/)

* [Roboto](https://fonts.google.com/specimen/Roboto)

* [RawGit](https://rawgit.com/)

* [st](https://st.suckless.org/)

* [GNU Screen](https://www.gnu.org/software/screen)

* [Vim](https://www.vim.org/)

* [Gogs](https://gogs.io/)

**Docutils Team.** *reStructuredText.* <http://docutils.sourceforge.net/rst.html>

**Mozilla Developer Network.** *JavaScript.* <https://developer.mozilla.org/en-US/docs/Web/JavaScript>



