How to set menu (#12)
* #11 moved to adoc from md * #11 fabfile to publish docs to gh-pages * #11 sidebar menu docs added
This commit is contained in:
Arul
GitHub
parent
a6aaa9eec3
commit
858c116b74
4 changed files with 339 additions and 197 deletions
3
.gitignore
vendored
Normal file
3
.gitignore
vendored
Normal file
|
|
@ -0,0 +1,3 @@
|
||||||
|
*.pyc
|
||||||
|
*.log
|
||||||
|
output
|
||||||
260
README.adoc
Normal file
260
README.adoc
Normal file
|
|
@ -0,0 +1,260 @@
|
||||||
|
[[pelican-attila-theme]]
|
||||||
|
= Attila
|
||||||
|
A content focused responsive pelican theme
|
||||||
|
:toc: left
|
||||||
|
|
||||||
|
[[overview]]
|
||||||
|
== Overview
|
||||||
|
|
||||||
|
A content focused responsive theme for
|
||||||
|
https://github.com/getpelican/pelican[Pelican].
|
||||||
|
|
||||||
|
It is ported from ghost theme
|
||||||
|
https://github.com/zutrinken/attila[attila]
|
||||||
|
|
||||||
|
[[demo]]
|
||||||
|
== Demo
|
||||||
|
|
||||||
|
* https://arulrajnet.github.io/attila-demo[Blog]
|
||||||
|
* https://arulrajnet.github.io/attila-demo/2015/11/headlines-blockquotes-images.html[Post]
|
||||||
|
* https://arulrajnet.github.io/attila-demo/tag/general/[Tag Archive]
|
||||||
|
* https://arulrajnet.github.io/attila-demo/author/zutrinken/[Author
|
||||||
|
Archive]
|
||||||
|
* https://arulrajnet.github.io/attila-demo/archives.html[All archive]
|
||||||
|
* https://arulrajnet.github.io/attila-demo/pages/about/[Page]
|
||||||
|
|
||||||
|
Demo blog https://github.com/arulrajnet/attila-demo[source code]
|
||||||
|
|
||||||
|
[[install]]
|
||||||
|
== Install
|
||||||
|
|
||||||
|
|
||||||
|
The recommend way to install is using pelican-themes command.
|
||||||
|
|
||||||
|
* Download latest zip from
|
||||||
|
https://github.com/arulrajnet/attila/releases[release]
|
||||||
|
* Unzip that file
|
||||||
|
* Then `sudo pelican-themes -U attila` . Here attila is the extracted
|
||||||
|
folder name
|
||||||
|
* Now list all themes `sudo pelican-themes -l`
|
||||||
|
* Use that theme name in your pelicanconf.py
|
||||||
|
|
||||||
|
[[features]]
|
||||||
|
== Features
|
||||||
|
|
||||||
|
* Responsive layout
|
||||||
|
* Navigation support
|
||||||
|
* Paralax cover images for posts, author archives and blog
|
||||||
|
* Author informations for posts and author archives
|
||||||
|
* Featured posts (via
|
||||||
|
https://github.com/getpelican/pelican-plugins/tree/master/neighbors[plugin])
|
||||||
|
* Reading progress for posts
|
||||||
|
* Automatic code syntax highlight
|
||||||
|
* Disqus support
|
||||||
|
* Google Analytics, GAUGES and PIWIKI
|
||||||
|
* Sharing buttons
|
||||||
|
* Open Graph
|
||||||
|
* Rich Snippets (JSON-LD)
|
||||||
|
* link:#code-highlights[Multiple Code Highlight Styles]
|
||||||
|
|
||||||
|
[[configuration]]
|
||||||
|
== Configurations
|
||||||
|
|
||||||
|
The attila docs hosted in http://arulrajnet.github.io/attila[attila-docs]
|
||||||
|
|
||||||
|
[[setup-a-blog]]
|
||||||
|
=== Setup a blog
|
||||||
|
|
||||||
|
Refer
|
||||||
|
https://github.com/arulrajnet/attila-demo/blob/master/pelicanconf.py[more
|
||||||
|
setting]
|
||||||
|
|
||||||
|
Here are all configurations about this theme.
|
||||||
|
|
||||||
|
[[header-covers]]
|
||||||
|
=== Header Covers
|
||||||
|
|
||||||
|
To define custom header cover, set the property `HEADER_COVER` in
|
||||||
|
`pelicanconf.py`:
|
||||||
|
|
||||||
|
[source,python]
|
||||||
|
----
|
||||||
|
HEADER_COVER = 'static/my_image.png'
|
||||||
|
----
|
||||||
|
|
||||||
|
This is site level cover image and it will be used If there is no cover
|
||||||
|
image set in link:#articles[article] level.
|
||||||
|
|
||||||
|
[[header-color]]
|
||||||
|
=== Header Color
|
||||||
|
|
||||||
|
To define a simple header background color, set the property
|
||||||
|
`HEADER_COLOR` in `pelicanconf.py`:
|
||||||
|
|
||||||
|
[source,python]
|
||||||
|
----
|
||||||
|
HEADER_COLOR = 'black'
|
||||||
|
----
|
||||||
|
|
||||||
|
you can use any valid css color. This will be used if there is no cover
|
||||||
|
image set in link:#articles[article] level and site level.
|
||||||
|
|
||||||
|
[[social-urls]]
|
||||||
|
=== Social URLs
|
||||||
|
|
||||||
|
Github, Twitter and Facebook URLs set these properties:
|
||||||
|
|
||||||
|
[source,python]
|
||||||
|
----
|
||||||
|
SOCIAL = (('twitter', 'https://twitter.com/myprofile'),
|
||||||
|
('github', 'https://github.com/myprofile'),
|
||||||
|
('facebook','https://facebook.com/myprofile'),
|
||||||
|
('flickr','https://www.flickr.com/myprofile/'),
|
||||||
|
('envelope','mailto:my@mail.address'))
|
||||||
|
----
|
||||||
|
|
||||||
|
[[external-feed-url]]
|
||||||
|
=== External feed URL
|
||||||
|
|
||||||
|
You can specify an external feed URL (e.g. FeedBurner) in `SOCIAL` using
|
||||||
|
the `rss` or `rss-square` or `feed` icons. A `<link>` tag for the
|
||||||
|
external feed will be placed in `<head>` instead of the default Pelican
|
||||||
|
feeds.
|
||||||
|
|
||||||
|
[[code-highlights]]
|
||||||
|
=== Code highlights
|
||||||
|
|
||||||
|
This theme contains this color schemes:
|
||||||
|
|
||||||
|
* Tomorrow - `tomorrow.css`;
|
||||||
|
* Tomorrow Night - `tomorrow_night.css`;
|
||||||
|
* Monokai - `monokai.css`;
|
||||||
|
* Github (Default) - `github.css`;
|
||||||
|
* Darkly - `darkly.css`;
|
||||||
|
|
||||||
|
To customize, define `COLOR_SCHEME_CSS` in `pelicanconf.py` with css
|
||||||
|
filename. Example:
|
||||||
|
|
||||||
|
[source,python]
|
||||||
|
----
|
||||||
|
COLOR_SCHEME_CSS = 'monokai.css'
|
||||||
|
----
|
||||||
|
|
||||||
|
[[user-defined-css]]
|
||||||
|
=== User defined CSS
|
||||||
|
|
||||||
|
Define `CSS_OVERRIDE` in `pelicanconf.py` to insert a user defined CSS
|
||||||
|
file after theme CSS. Example:
|
||||||
|
|
||||||
|
Array of CSS you can give
|
||||||
|
|
||||||
|
[source,python]
|
||||||
|
----
|
||||||
|
CSS_OVERRIDE = ['css/myblog.css']
|
||||||
|
----
|
||||||
|
|
||||||
|
[[user-defined-script]]
|
||||||
|
=== User defined script
|
||||||
|
|
||||||
|
[source,python]
|
||||||
|
----
|
||||||
|
JS_OVERRIDE = ['']
|
||||||
|
----
|
||||||
|
|
||||||
|
[[author-bio]]
|
||||||
|
=== Author Bio
|
||||||
|
|
||||||
|
....
|
||||||
|
AUTHORS_BIO = {
|
||||||
|
"zutrinken": {
|
||||||
|
"name": "Zutrinken",
|
||||||
|
"cover": "https://arulrajnet.github.io/attila-demo/assets/images/avatar.png",
|
||||||
|
"image": "https://arulrajnet.github.io/attila-demo/assets/images/avatar.png",
|
||||||
|
"website": "http://blog.arulraj.net",
|
||||||
|
"location": "Chennai",
|
||||||
|
"bio": "This is the place for a small biography with max 200 characters. Well, now 100 are left. Cool, hugh?"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
....
|
||||||
|
|
||||||
|
[[analytics]]
|
||||||
|
=== Analytics
|
||||||
|
|
||||||
|
Accept many analytics:
|
||||||
|
|
||||||
|
* Google Analytics: `GOOGLE_ANALYTICS`;
|
||||||
|
* Gauges: `GAUGES`
|
||||||
|
* Piwik: `PIWIK_URL` and `PIWIK_SITE_ID`.
|
||||||
|
|
||||||
|
[[sidebar-menu]]
|
||||||
|
=== Sidebar Menu
|
||||||
|
|
||||||
|
The menu item coming from pelican pages.
|
||||||
|
You have to create pages folder under link::https://github.com/arulrajnet/attila-demo/tree/master/content/pages[content directory].
|
||||||
|
Whatever articles there in this folder will be pages.
|
||||||
|
|
||||||
|
|
||||||
|
[[articles]]
|
||||||
|
=== Article Cover
|
||||||
|
|
||||||
|
* To customize header color to articles, insert the metadata `color`.
|
||||||
|
* To customize header cover to articles, insert the metadata `cover`,
|
||||||
|
otherwise `og_image` or `HEADER_COVER` will be used.
|
||||||
|
* To customize OpenGraph images, insert the metadata `og_image`,
|
||||||
|
otherwise `cover`, `HEADER_COVER` or a
|
||||||
|
https://github.com/arulrajnet/attila/blob/master/static/images/post-bg.jpg[default
|
||||||
|
image] from theme will be used.
|
||||||
|
* To customize Twitter card images, insert the metadata `twitter_image`,
|
||||||
|
otherwise `header_cover`, `HEADER_COVER` or a default image from theme
|
||||||
|
will be used. Twitter cards will be generated automatically if the
|
||||||
|
`twitter` account is configured in `SOCIAL`!
|
||||||
|
|
||||||
|
All image paths are relative from the site root directory. You can also
|
||||||
|
use absolute URLs for `og_image` and `twitter_image`.
|
||||||
|
|
||||||
|
|
||||||
|
[[other-configuration]]
|
||||||
|
=== Other configuration
|
||||||
|
|
||||||
|
* `GOOGLE_SITE_VERIFICATION` - Google site verification token;
|
||||||
|
* Set `SHOW_FULL_ARTICLE` to True to show full article content on
|
||||||
|
index.html instead of summary;
|
||||||
|
* Set `FACEBOOK_ADMINS` to a list of Facebook account IDs which are
|
||||||
|
associated with this blog. For example `['12345']`. For more info see
|
||||||
|
https://developers.facebook.com/docs/platforminsights/domains
|
||||||
|
|
||||||
|
[[development]]
|
||||||
|
== Development
|
||||||
|
|
||||||
|
refer this https://github.com/arulrajnet/attila-demo
|
||||||
|
|
||||||
|
*Author Screen* image:screenshot.png[screenshot]
|
||||||
|
|
||||||
|
[[contributing]]
|
||||||
|
=== Contributing
|
||||||
|
|
||||||
|
Always open an issue before sending a PR. Talk about the problem/feature
|
||||||
|
that you want to fix. If it’s really a good thing you can submit your
|
||||||
|
PR. If you send an PR without talking about before what it is, you may
|
||||||
|
work for nothing.
|
||||||
|
|
||||||
|
As always, if you want something that only make sense to you, just fork
|
||||||
|
attila and start a new theme.
|
||||||
|
|
||||||
|
[[donate]]
|
||||||
|
== Donate
|
||||||
|
|
||||||
|
Did you liked this theme? Pay my bills and support new features.
|
||||||
|
|
||||||
|
https://gratipay.com/~arulrajnet/[image:https://img.shields.io/gratipay/user/arulrajnet.svg?maxAge=2592000[Gratipay]]
|
||||||
|
|
||||||
|
https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=XYLX6LG2THL2J[image:https://img.shields.io/badge/paypal-donate-yellow.svg?maxAge=2592000[PayPal]]
|
||||||
|
|
||||||
|
[[copyright-license]]
|
||||||
|
== Copyright & License
|
||||||
|
|
||||||
|
Copyright (c) 2015-2016 Peter Amende - Released under The MIT License.
|
||||||
|
Copyright (c) 2016 Arulraj V - Released under The MIT License.
|
||||||
|
|
||||||
|
Some background images used from
|
||||||
|
https://github.com/gilsondev/pelican-clean-blog
|
||||||
197
README.md
197
README.md
|
|
@ -1,197 +0,0 @@
|
||||||
# Pelican Attila Theme
|
|
||||||
|
|
||||||
A content focused responsive theme for [Pelican](https://github.com/getpelican/pelican).
|
|
||||||
|
|
||||||
It is ported from ghost theme [attila](https://github.com/zutrinken/attila)
|
|
||||||
|
|
||||||
## Demo
|
|
||||||
|
|
||||||
* [Blog](https://arulrajnet.github.io/attila-demo)
|
|
||||||
* [Post](https://arulrajnet.github.io/attila-demo/2015/11/headlines-blockquotes-images.html)
|
|
||||||
* [Tag Archive](https://arulrajnet.github.io/attila-demo/tag/general/)
|
|
||||||
* [Author Archive](https://arulrajnet.github.io/attila-demo/author/zutrinken/)
|
|
||||||
* [All archive](https://arulrajnet.github.io/attila-demo/archives.html)
|
|
||||||
* [Page](https://arulrajnet.github.io/attila-demo/pages/about/)
|
|
||||||
|
|
||||||
Demo blog [source code](https://github.com/arulrajnet/attila-demo)
|
|
||||||
|
|
||||||
## Install
|
|
||||||
|
|
||||||
The recommend way to install is using pelican-themes command.
|
|
||||||
|
|
||||||
* Download latest zip from [release](https://github.com/arulrajnet/attila/releases)
|
|
||||||
* Unzip that file
|
|
||||||
* Then `sudo pelican-themes -U attila` . Here attila is the extracted folder name
|
|
||||||
* Now list all themes `sudo pelican-themes -l`
|
|
||||||
* Use that theme name in your pelicanconf.py
|
|
||||||
|
|
||||||
## Features
|
|
||||||
|
|
||||||
* Responsive layout
|
|
||||||
* Navigation support
|
|
||||||
* Paralax cover images for posts, author archives and blog
|
|
||||||
* Author informations for posts and author archives
|
|
||||||
* Featured posts (via [plugin](https://github.com/getpelican/pelican-plugins/tree/master/neighbors))
|
|
||||||
* Reading progress for posts
|
|
||||||
* Automatic code syntax highlight
|
|
||||||
* Disqus support
|
|
||||||
* Google Analytics, GAUGES and PIWIKI
|
|
||||||
* Sharing buttons
|
|
||||||
* Open Graph
|
|
||||||
* Rich Snippets (JSON-LD)
|
|
||||||
* [Multiple Code Highlight Styles](#code-highlights)
|
|
||||||
|
|
||||||
## Docs
|
|
||||||
|
|
||||||
[Wiki](https://github.com/arulrajnet/attila/wiki)
|
|
||||||
|
|
||||||
## Setup a blog
|
|
||||||
|
|
||||||
Refer [more setting](https://github.com/arulrajnet/attila-demo/blob/master/pelicanconf.py)
|
|
||||||
|
|
||||||
Here are all configurations about this theme.
|
|
||||||
|
|
||||||
#### Header Covers
|
|
||||||
|
|
||||||
To define custom header cover, set the property ``HEADER_COVER`` in ``pelicanconf.py``:
|
|
||||||
|
|
||||||
```python
|
|
||||||
HEADER_COVER = 'static/my_image.png'
|
|
||||||
```
|
|
||||||
|
|
||||||
This is site level cover image and it will be used If there is no cover image set in [article](#articles) level.
|
|
||||||
|
|
||||||
#### Header Color
|
|
||||||
|
|
||||||
To define a simple header background color, set the property ``HEADER_COLOR`` in ``pelicanconf.py``:
|
|
||||||
|
|
||||||
```python
|
|
||||||
HEADER_COLOR = 'black'
|
|
||||||
```
|
|
||||||
|
|
||||||
you can use any valid css color. This will be used if there is no cover image set in [article](#articles) level and site level.
|
|
||||||
|
|
||||||
#### Social URLs
|
|
||||||
|
|
||||||
Github, Twitter and Facebook URLs set these properties:
|
|
||||||
|
|
||||||
```python
|
|
||||||
SOCIAL = (('twitter', 'https://twitter.com/myprofile'),
|
|
||||||
('github', 'https://github.com/myprofile'),
|
|
||||||
('facebook','https://facebook.com/myprofile'),
|
|
||||||
('flickr','https://www.flickr.com/myprofile/'),
|
|
||||||
('envelope','mailto:my@mail.address'))
|
|
||||||
```
|
|
||||||
|
|
||||||
#### External feed URL
|
|
||||||
|
|
||||||
You can specify an external feed URL (e.g. FeedBurner) in ``SOCIAL`` using the
|
|
||||||
``rss`` or ``rss-square`` or ``feed`` icons. A ``<link>`` tag for the external feed will be
|
|
||||||
placed in ``<head>`` instead of the default Pelican feeds.
|
|
||||||
|
|
||||||
#### Code highlights
|
|
||||||
|
|
||||||
This theme contains this color schemes:
|
|
||||||
|
|
||||||
- Tomorrow - ``tomorrow.css``;
|
|
||||||
- Tomorrow Night - ``tomorrow_night.css``;
|
|
||||||
- Monokai - ``monokai.css``;
|
|
||||||
- Github (Default) - ``github.css``;
|
|
||||||
- Darkly - ``darkly.css``;
|
|
||||||
|
|
||||||
To customize, define ``COLOR_SCHEME_CSS`` in ``pelicanconf.py`` with css filename. Example:
|
|
||||||
|
|
||||||
```python
|
|
||||||
COLOR_SCHEME_CSS = 'monokai.css'
|
|
||||||
```
|
|
||||||
|
|
||||||
#### User defined CSS
|
|
||||||
|
|
||||||
Define ``CSS_OVERRIDE`` in ``pelicanconf.py`` to insert a user defined CSS file
|
|
||||||
after theme CSS. Example:
|
|
||||||
|
|
||||||
Array of CSS you can give
|
|
||||||
|
|
||||||
```python
|
|
||||||
CSS_OVERRIDE = ['css/myblog.css']
|
|
||||||
```
|
|
||||||
|
|
||||||
#### User defined script
|
|
||||||
|
|
||||||
```python
|
|
||||||
JS_OVERRIDE = ['']
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Author Bio
|
|
||||||
|
|
||||||
```
|
|
||||||
AUTHORS_BIO = {
|
|
||||||
"zutrinken": {
|
|
||||||
"name": "Zutrinken",
|
|
||||||
"cover": "https://arulrajnet.github.io/attila-demo/assets/images/avatar.png",
|
|
||||||
"image": "https://arulrajnet.github.io/attila-demo/assets/images/avatar.png",
|
|
||||||
"website": "http://blog.arulraj.net",
|
|
||||||
"location": "Chennai",
|
|
||||||
"bio": "This is the place for a small biography with max 200 characters. Well, now 100 are left. Cool, hugh?"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Analytics
|
|
||||||
|
|
||||||
Accept many analytics:
|
|
||||||
|
|
||||||
- Google Analytics: ``GOOGLE_ANALYTICS``;
|
|
||||||
- Gauges: ``GAUGES``
|
|
||||||
- Piwik: ``PIWIK_URL`` and ``PIWIK_SITE_ID``.
|
|
||||||
|
|
||||||
#### Other configuration
|
|
||||||
|
|
||||||
- ``GOOGLE_SITE_VERIFICATION`` - Google site verification token;
|
|
||||||
- Set ``SHOW_FULL_ARTICLE`` to True to show full article content on index.html
|
|
||||||
instead of summary;
|
|
||||||
- Set ``FACEBOOK_ADMINS`` to a list of Facebook account IDs which are
|
|
||||||
associated with this blog. For example ``['12345']``. For more info see
|
|
||||||
https://developers.facebook.com/docs/platforminsights/domains
|
|
||||||
|
|
||||||
#### Articles
|
|
||||||
|
|
||||||
- To customize header color to articles, insert the metadata ``color``.
|
|
||||||
- To customize header cover to articles, insert the metadata ``cover``, otherwise ``og_image`` or ``HEADER_COVER`` will be used.
|
|
||||||
- To customize OpenGraph images, insert the metadata ``og_image``, otherwise
|
|
||||||
``cover``, ``HEADER_COVER`` or a [default image](https://github.com/arulrajnet/attila/blob/master/static/images/post-bg.jpg) from theme will be used.
|
|
||||||
- To customize Twitter card images, insert the metadata ``twitter_image``,
|
|
||||||
otherwise ``header_cover``, ``HEADER_COVER`` or a default image from theme will be used.
|
|
||||||
Twitter cards will be generated automatically if the ``twitter`` account is configured
|
|
||||||
in ``SOCIAL``!
|
|
||||||
|
|
||||||
All image paths are relative from the site root directory. You can also use
|
|
||||||
absolute URLs for ``og_image`` and ``twitter_image``.
|
|
||||||
|
|
||||||
## Development
|
|
||||||
|
|
||||||
refer this [https://github.com/arulrajnet/attila-demo](https://github.com/arulrajnet/attila-demo)
|
|
||||||
|
|
||||||
**Author Screen**
|
|
||||||
|
|
||||||
|
|
||||||
## Contributing
|
|
||||||
|
|
||||||
Always open an issue before sending a PR. Talk about the problem/feature that you want to fix. If it's really a good thing you can submit your PR. If you send an PR without talking about before what it is, you may work for nothing.
|
|
||||||
|
|
||||||
As always, if you want something that only make sense to you, just fork attila and start a new theme.
|
|
||||||
|
|
||||||
## Donate
|
|
||||||
|
|
||||||
Did you liked this theme? Pay my bills and support new features.
|
|
||||||
|
|
||||||
[](https://gratipay.com/~arulrajnet/)
|
|
||||||
|
|
||||||
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=XYLX6LG2THL2J)
|
|
||||||
|
|
||||||
## Copyright & License
|
|
||||||
|
|
||||||
Copyright (c) 2015-2016 Peter Amende - Released under The MIT License.
|
|
||||||
Copyright (c) 2016 Arulraj V - Released under The MIT License.
|
|
||||||
|
|
||||||
Some background images used from https://github.com/gilsondev/pelican-clean-blog
|
|
||||||
76
fabfile.py
vendored
Normal file
76
fabfile.py
vendored
Normal file
|
|
@ -0,0 +1,76 @@
|
||||||
|
from fabric.api import *
|
||||||
|
import fabric.contrib.project as project
|
||||||
|
import os
|
||||||
|
import shutil
|
||||||
|
import sys
|
||||||
|
import SocketServer
|
||||||
|
|
||||||
|
from pelican.server import ComplexHTTPRequestHandler
|
||||||
|
|
||||||
|
# Local path configuration (can be absolute or relative to fabfile)
|
||||||
|
env.deploy_path = 'output'
|
||||||
|
DEPLOY_PATH = env.deploy_path
|
||||||
|
|
||||||
|
# Remote server configuration
|
||||||
|
production = 'root@localhost:22'
|
||||||
|
dest_path = '/var/www'
|
||||||
|
|
||||||
|
# Rackspace Cloud Files configuration settings
|
||||||
|
env.cloudfiles_username = 'my_rackspace_username'
|
||||||
|
env.cloudfiles_api_key = 'my_rackspace_api_key'
|
||||||
|
env.cloudfiles_container = 'my_cloudfiles_container'
|
||||||
|
|
||||||
|
# Github Pages configuration
|
||||||
|
env.github_pages_branch = "gh-pages"
|
||||||
|
|
||||||
|
# Port for `serve`
|
||||||
|
PORT = 8000
|
||||||
|
|
||||||
|
def clean():
|
||||||
|
"""Remove generated files"""
|
||||||
|
if os.path.isdir(DEPLOY_PATH):
|
||||||
|
shutil.rmtree(DEPLOY_PATH)
|
||||||
|
os.makedirs(DEPLOY_PATH)
|
||||||
|
|
||||||
|
def build():
|
||||||
|
"""Build local version of site"""
|
||||||
|
local('asciidoctor -D {deploy_path} *.adoc'.format(**env))
|
||||||
|
local('cp *.png {deploy_path}'.format(**env))
|
||||||
|
local('mv {deploy_path}/README.html {deploy_path}/index.html'.format(**env))
|
||||||
|
|
||||||
|
def rebuild():
|
||||||
|
"""`clean` then `build`"""
|
||||||
|
clean()
|
||||||
|
build()
|
||||||
|
|
||||||
|
def serve():
|
||||||
|
"""Serve site at http://localhost:8000/"""
|
||||||
|
os.chdir(env.deploy_path)
|
||||||
|
|
||||||
|
class AddressReuseTCPServer(SocketServer.TCPServer):
|
||||||
|
allow_reuse_address = True
|
||||||
|
|
||||||
|
server = AddressReuseTCPServer(('', PORT), ComplexHTTPRequestHandler)
|
||||||
|
|
||||||
|
sys.stderr.write('Serving on port {0} ...\n'.format(PORT))
|
||||||
|
server.serve_forever()
|
||||||
|
|
||||||
|
def reserve():
|
||||||
|
"""`build`, then `serve`"""
|
||||||
|
build()
|
||||||
|
serve()
|
||||||
|
|
||||||
|
def cf_upload():
|
||||||
|
"""Publish to Rackspace Cloud Files"""
|
||||||
|
rebuild()
|
||||||
|
with lcd(DEPLOY_PATH):
|
||||||
|
local('swift -v -A https://auth.api.rackspacecloud.com/v1.0 '
|
||||||
|
'-U {cloudfiles_username} '
|
||||||
|
'-K {cloudfiles_api_key} '
|
||||||
|
'upload -c {cloudfiles_container} .'.format(**env))
|
||||||
|
|
||||||
|
def gh_pages():
|
||||||
|
"""Publish to GitHub Pages"""
|
||||||
|
rebuild()
|
||||||
|
local("ghp-import -b {github_pages_branch} {deploy_path}".format(**env))
|
||||||
|
local("git push origin {github_pages_branch}".format(**env))
|
||||||
Loading…
Add table
Add a link
Reference in a new issue