:wink: This is where it all begins...

1 files changed, 128 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a4791b1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,128 @@
+![Sustain - Logo][logo]
+
+Table of Contents
+-----------------
+
+- [Installation](#installation)
+- [Quick start](#quick-start)
+- [Features](#features)
+  - [Syntax highlighting](#syntax-highlighting)
+  - [Disqus](#disqus)
+  - [Google Analytics](#google-analytics)
+- [About](#about)
+- [Contributing](#contributing)
+- [Changelog](#changelog)
+- [License](#license)
+
+********************
+
+![Sustain Screen][screenshot]
+
+********************
+
+<p align="center"><b><a href="https://demo.sumaxi.me/themes/hugo-sustain/">Sustain Live Demo</a></b></p>
+
+Installation
+------------
+
+#### With `git`
+
+From the root of your Hugo site, clone the theme into `themes/hugo-sustain` by running : 
+```
+git clone https://github.com/sumaxime/hugo-sustain.git themes/hugo-sustain
+```
+
+#### Manual
+
+1. [Download][zip-archive] zip archive.
+2. Unarchive it.
+3. Move `hugo-sustain` folder in `themes` folder of your blog
+
+For more information read the official [setup guide][hugo-guide] of Hugo.
+
+Quick start
+-----------
+
+After installation, take a look in the `exampleSite` folder at. This directory contains an example config file and the content for the demo. It serves as an example setup for your documentation.
+
+```
+  exampleSite
+  ├── config.toml
+  ├── content
+  │   ├── projects
+  │   │   └── index.md
+  │   └── blog
+  │       ├── creating-a-new-theme.md
+  │       ├── go-is-for-lovers.md
+  │       ├── hugo-is-for-lovers.md
+  │       └── migrate-from-jekyll.md
+  └── static
+```
+
+Copy at least the `config.toml` in the root directory of your website. Overwrite the existing config file if necessary. 
+
+Hugo includes a development server, so you can view your changes as you go -
+very handy. Spin it up with the following command:
+
+``` sh
+hugo serve
+```
+
+Now you can go to [localhost:1313][local] and the Sustain
+theme should be visible.
+
+Features
+--------
+
+### Syntax highlighting
+
+Use `highlight = true` in the front matter to include [`highlight.js`][highlight-js] javascript and css files.
+
+### Disqus
+
+To use this feature, uncomment and fill out the `disqusShortname` parameter in config.toml`.
+
+### Google Analytics
+
+To add Google Analytics, simply sign up to [Google Analytics][g-analytics] to obtain your Google Tracking ID, and add this tracking ID to the `googleAnalytics` parameter in `config.toml`.
+
+About
+-----
+
+This is a port of the Jekyll theme [Sustain][sustain-jekyll] by [Fábio Madeira][sustain-author]. It supports most of the features of the original theme.
+
+Contributing
+------------
+
+Pull requests, bug fixes, and new features are welcome!
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -a -m 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request on GitHub
+
+Changelog
+---------
+
+> Version 1.0
+
+- Initial release
+
+License
+-------
+
+This theme is released under the [MIT license](LICENSE.md).
+
+[logo]: https://i1.sumaxi.me/i/sustain.png
+[screenshot]: https://i1.sumaxi.me/i/sustain-screen.png
+[bootstrap]: https://getbootstrap.com/
+[hugo]: https://gohugo.io/
+[gh-pages]: https://pages.github.com/
+[zip-archive]: https://github.com/sumaxime/hugo-sustain/archive/master.zip
+[hugo-guide]: https://gohugo.io/overview/installing/
+[local]: http://localhost:1313/
+[highlight-js]: https://highlightjs.org/
+[g-analytics]: https://www.google.com/analytics/
+[sustain-jekyll]: https://github.com/biomadeira/sustain/
+[sustain-author]: https://github.com/biomadeira/