mirror of
https://github.com/vale981/ablog
synced 2025-03-06 01:31:39 -05:00
Added a post, updated release notes, incremented version number.
This commit is contained in:
parent
a99b6d0b36
commit
5e2bbd9085
5 changed files with 119 additions and 7 deletions
2
Makefile
2
Makefile
|
@ -7,7 +7,7 @@ demo:
|
|||
printf "demo\nABlog\nABlog Team\nhttp://ablog.readthedocs.org" | ablog start
|
||||
|
||||
install:
|
||||
pip install -U --no-deps --force-reinstall .
|
||||
sudo pip install -U --no-deps --force-reinstall .
|
||||
|
||||
rebuild:
|
||||
cd docs; watchmedo shell-command --patterns='*.rst' --command='ablog build' --recursive
|
||||
|
|
|
@ -8,7 +8,7 @@ from .post import (PostDirective, PostListDirective, UpdateDirective,
|
|||
generate_archive_pages, generate_atom_feeds,
|
||||
missing_reference)
|
||||
|
||||
__version__ = '0.7.0'
|
||||
__version__ = '0.7.1'
|
||||
|
||||
|
||||
def anchor(post):
|
||||
|
|
|
@ -96,17 +96,19 @@ server and open up browser tab to view your website.
|
|||
::
|
||||
|
||||
$ ablog serve -h
|
||||
usage: ablog serve [-h] [-n] [-p PORT] [-w WEBSITE]
|
||||
usage: ablog serve [-h] [-w WEBSITE] [-p PORT] [-n] [-r] [--patterns]
|
||||
|
||||
Serve options can be set in conf.py. Default values of paths are relative to
|
||||
conf.py.
|
||||
|
||||
optional arguments:
|
||||
-h, --help show this help message and exit
|
||||
-n do not open website in a new browser tab
|
||||
-p PORT port number for HTTP server; default is 8000
|
||||
-w WEBSITE path for website, default is _website when `ablog_website` is
|
||||
not set in conf.py
|
||||
-p PORT port number for HTTP server; default is 8000
|
||||
-n do not open website in a new browser tab
|
||||
-r rebuild when a file matching patterns change or get added
|
||||
--patterns patterns for triggering rebuilds
|
||||
|
||||
.. _deploy:
|
||||
|
||||
|
|
99
docs/manual/auto-github-pages-deploys.rst
Normal file
99
docs/manual/auto-github-pages-deploys.rst
Normal file
|
@ -0,0 +1,99 @@
|
|||
Automate GitHub Pages Deploys
|
||||
=============================
|
||||
|
||||
.. post:: Jun 15, 2015
|
||||
:tags: deploy, tips
|
||||
:category: Manual
|
||||
:author: Ahmet
|
||||
:location: Denizli
|
||||
:language: en
|
||||
|
||||
|
||||
If being away from your personal computer is holding you from blogging, keep
|
||||
reading. This post will show you how to automate builds and deploys using
|
||||
Travis CI. Once you set this up, all you need to do post an article will be
|
||||
pushing to GitHub or creating a new file on GitHub.com from any computer!
|
||||
|
||||
For this to work, you need to be hosting your website on GitHub pages.
|
||||
If you are not already doing so, see :ref:`deploy-to-github-pages`.
|
||||
|
||||
|
||||
Signup for Travis CI
|
||||
--------------------
|
||||
|
||||
Travis CI is a continuous integration service used to build and test projects
|
||||
hosted at GitHub. You can easily sync your GitHub projects with Travis CI
|
||||
by logging to Travis CI using your GitHub account:
|
||||
|
||||
.. figure:: images/TravisCI_login.png
|
||||
:scale: 30 %
|
||||
:align: center
|
||||
|
||||
|
||||
Once you login, go to :guilabel:`Account` page and flick the switch on for your GitHub
|
||||
pages source repository. In the below example, source repository is **website**
|
||||
and will be pushed to *abakan.github.io*:
|
||||
|
||||
.. figure:: images/TravisCI_accounts.png
|
||||
:scale: 30 %
|
||||
:align: center
|
||||
|
||||
|
||||
Deploy key setup
|
||||
----------------
|
||||
|
||||
To have builds pushed from Travis CI to GitHub, you will need a *personal access
|
||||
token*. Go to GitHub :menuselection:`Settings --> Personal access tokens` page to
|
||||
generate a new token. You need only *public repo* access checked for this purpose:
|
||||
|
||||
.. figure:: images/GitHub_token.png
|
||||
:scale: 30 %
|
||||
:align: center
|
||||
|
||||
|
||||
Then, you need to set this access token as an environment variable, e.g.
|
||||
``DEPLOY_KEY``, under :menuselection:`Settings --> Environment Variables`.
|
||||
Keep the :guilabel:Display value in build logs` switch off.
|
||||
|
||||
.. figure:: images/TravisCI_settings.png
|
||||
:scale: 30 %
|
||||
:align: center
|
||||
|
||||
|
||||
Also, do not forget to flick :guilabel:`Build pushes` on under
|
||||
:menuselection:`Settings --> General Settings`:
|
||||
|
||||
.. figure:: images/TravisCI_global.png
|
||||
:scale: 60 %
|
||||
:align: center
|
||||
|
||||
Configuration file
|
||||
------------------
|
||||
|
||||
Finally, you need a :file:`.travis.yml` in your project that looks like the
|
||||
following:
|
||||
|
||||
|
||||
.. code-block:: yaml
|
||||
|
||||
language: python
|
||||
|
||||
python:
|
||||
- 2.7
|
||||
|
||||
virtualenv:
|
||||
system_site_packages: true
|
||||
|
||||
before_install:
|
||||
- pip install ablog
|
||||
|
||||
script:
|
||||
- ablog build
|
||||
|
||||
after_success:
|
||||
- git config --global user.name "Your Name"
|
||||
- git config --global user.email "yourname@domain.com"
|
||||
- git config --global push.default simple
|
||||
- ablog deploy --push-quietly --github-token=DEPLOY_KEY -m="`git log -1 --pretty=%B`"
|
||||
|
||||
|
|
@ -1,4 +1,4 @@
|
|||
ABlog v0.7.0 released
|
||||
ABlog v0.7 released
|
||||
===================
|
||||
|
||||
.. post:: May 3, 2015
|
||||
|
@ -11,3 +11,14 @@ ABlog v0.7.0 is released to fix the long standing :issue:`1` related to
|
|||
pickling of Sphinx build environment on Read The Docs. Improvements
|
||||
also resolved issues with using LaTeX builder, improved cross-referencing
|
||||
for non-html builders.
|
||||
|
||||
|
||||
ABlog v0.7.1 released
|
||||
---------------------
|
||||
|
||||
.. post:: Jun 15, 2015
|
||||
:author: Ahmet
|
||||
:category: Release
|
||||
:location: SF
|
||||
|
||||
ABlog v0.7.1 is released to fix import issues in :ref:`ablog-serve` command.
|
||||
|
|
Loading…
Add table
Reference in a new issue