Skip to content

Commit

Permalink
Reorganise documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
deanishe committed Sep 14, 2014
1 parent 2721932 commit 8c5c319
Show file tree
Hide file tree
Showing 51 changed files with 2,509 additions and 1,236 deletions.
10 changes: 6 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -172,13 +172,13 @@ wf.get_password('name of account')

## Documentation ##

The full documentation, including auto-generated API docs and a tutorial, can be found [here](http://www.deanishe.net/alfred-workflow/).
The full documentation, including API docs and a tutorial, can be found [here](http://alfredworkflow.readthedocs.org/en/latest/).

## Licensing, thanks ##

The code and the documentation are released under the MIT and [Creative Commons Attribution-NonCommercial](https://creativecommons.org/licenses/by-nc/4.0/legalcode) licences respectively. See LICENSE for details.

The documentation was generated using [Sphinx](http://sphinx-doc.org/), [Sphinx Bootstrap Theme](http://ryan-roemer.github.io/sphinx-bootstrap-theme/), [Bootstrap](http://getbootstrap.com/) and the [Readable Bootswatch theme](http://bootswatch.com/readable/).
The documentation was generated using [Sphinx](http://sphinx-doc.org/) and is hosted by the lovely folks at [Read the Docs](https://readthedocs.org/).

## Contributing ##

Expand Down Expand Up @@ -218,7 +218,7 @@ These are some of the Alfred workflows that use this library.
- [Code Case](http://www.packal.org/workflow/code-case) by [dfay](http://www.packal.org/users/dfay). Case Converter for Code.
- [Convert](http://www.packal.org/workflow/convert) by [deanishe](http://www.packal.org/users/deanishe). Convert between different units. No Internet connection required.
- [Date Calculator](http://www.packal.org/workflow/date-calculator) by [MuppetGate](http://www.packal.org/users/muppetgate). A basic date calculator.
- [Digital Ocean status](http://www.packal.org/workflow/digital-ocean-status) by [frankspin](http://www.packal.org/users/frankspin). Check the status of your Digital Ocean droplets.
- [Digital Ocean status](http://www.packal.org/workflow/digital-ocean-status) by [frankspin](http://www.packal.org/users/frankspin). Control your Digital Ocean droplets.
- [Display Brightness](http://www.packal.org/workflow/display-brightness) by [fniephaus](http://www.packal.org/users/fniephaus). Adjust your display's brightness with Alfred.
- [Dropbox Client for Alfred](http://www.packal.org/workflow/dropbox-client-alfred) by [fniephaus](http://www.packal.org/users/fniephaus). Access multiple Dropbox accounts with Alfred.
- [Duden Search](http://www.packal.org/workflow/duden-search) by [deanishe](http://www.packal.org/users/deanishe). Search duden.de German dictionary (with auto-suggest).
Expand All @@ -228,6 +228,7 @@ These are some of the Alfred workflows that use this library.
- [Glosbe Translation](http://www.packal.org/workflow/glosbe-translation) by [deanishe](http://www.packal.org/users/deanishe). Translate text using Glosbe.com.
- [Homebrew for Alfred](http://www.packal.org/workflow/homebrew-alfred) by [fniephaus](http://www.packal.org/users/fniephaus). Easily control Homebrew with Alfred.
- [IPython Notebooks](http://www.packal.org/workflow/ipython-notebooks) by [nkeim](http://www.packal.org/users/nkeim). Search notebook titles on your IPython notebook server.
- [Jenkins](http://www.packal.org/workflow/jenkins) by [Amwam](http://www.packal.org/users/amwam). Show and search through jobs on Jenkins.
- [Laser SSH](http://www.packal.org/workflow/laser-ssh) by [paperElectron](http://www.packal.org/users/paperelectron). Choose SSH connection from filterable list.
- [LibGen](http://www.packal.org/workflow/libgen) by [hackademic](http://www.packal.org/users/hackademic). Search and Download pdfs and ebooks from Library Genesis.
- [Network Location](http://www.packal.org/workflow/network-location) by [deanishe](http://www.packal.org/users/deanishe). List, filter and activate network locations from within Alfred.
Expand All @@ -239,6 +240,7 @@ These are some of the Alfred workflows that use this library.
- [Quick Stocks](http://www.packal.org/workflow/quick-stocks) by [paperElectron](http://www.packal.org/users/paperelectron). Add some stock symbols for Alfred to check for you.
- [Readability for Alfred](http://www.packal.org/workflow/readability-alfred) by [fniephaus](http://www.packal.org/users/fniephaus). Manage your Readability list with Alfred.
- [Relative Dates](http://www.packal.org/workflow/relative-dates) by [deanishe](http://www.packal.org/users/deanishe). Generate relative dates based on a simple input format.
- [Resolve URL](http://www.packal.org/workflow/resolve-url) by [deanishe](http://www.packal.org/users/deanishe). Follows any HTTP redirects and returns the canonical URL. Also displays information about the primary host (hostname, IP address(es), aliases).
- [SEND](http://www.packal.org/workflow/send) by [hackademic](http://www.packal.org/users/hackademic). Send documents to the cloud.
- [Searchio!](http://www.packal.org/workflow/searchio) by [deanishe](http://www.packal.org/users/deanishe). Auto-suggest search results from multiple search engines and languages.
- [Skimmer](http://www.packal.org/workflow/skimmer) by [hackademic](http://www.packal.org/users/hackademic). Actions for PDF viewer Skim.
Expand All @@ -251,4 +253,4 @@ These are some of the Alfred workflows that use this library.
- [VM Control](http://www.packal.org/workflow/vm-control) by [fniephaus](http://www.packal.org/users/fniephaus). Control your Parallels and Virtual Box virtual machines.
- [VagrantUP](http://www.packal.org/workflow/vagrantup) by [m1keil](http://www.packal.org/users/m1keil). List and control Vagrant environments with Alfred2.
- [Wikify](http://www.packal.org/workflow/wikify) by [hackademic](http://www.packal.org/users/hackademic). Your little Evernote Wiki-Helper.
- [ZotQuery](http://www.packal.org/workflow/zotquery) by [hackademic](http://www.packal.org/users/hackademic). Search Zotero. From the Comfort of Your Keyboard.
- [ZotQuery](http://www.packal.org/workflow/zotquery) by [hackademic](http://www.packal.org/users/hackademic). Search Zotero. From the Comfort of Your Keyboard.
4 changes: 2 additions & 2 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -116,5 +116,5 @@ Or like this::
Documentation
=============

Detailed documentation, including a tutorial and auto-generated API docs, is
available at `the Alfred-Workflow website <http://www.deanishe.net/alfred-workflow/>`_.
Detailed documentation, including a tutorial and API docs, is
available at `Read the Docs <http://alfredworkflow.readthedocs.org/en/latest/>`_.
Binary file modified alfred-workflow.zip
Binary file not shown.
1 change: 1 addition & 0 deletions doc/_templates/layout.html
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@


{% block body %}
{{ super() }}
<div class="github-fork-ribbon-wrapper right">
<div class="github-fork-ribbon">
<a href="https://github.com/deanishe/alfred-workflow">Fork me on GitHub</a>
Expand Down
17 changes: 17 additions & 0 deletions doc/_themes/sphinx_rtd_theme/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
"""Sphinx ReadTheDocs theme.
From https://github.com/ryan-roemer/sphinx-bootstrap-theme.
"""
import os

VERSION = (0, 1, 6)

__version__ = ".".join(str(v) for v in VERSION)
__version_full__ = __version__


def get_html_theme_path():
"""Return list of HTML theme paths."""
cur_dir = os.path.abspath(os.path.dirname(os.path.dirname(__file__)))
return cur_dir
19 changes: 19 additions & 0 deletions doc/_themes/sphinx_rtd_theme/breadcrumbs.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="{{ pathto(master_doc) }}">Docs</a> &raquo;</li>
{% for doc in parents %}
<li><a href="{{ doc.link|e }}">{{ doc.title }}</a> &raquo;</li>
{% endfor %}
<li>{{ title }}</li>
<li class="wy-breadcrumbs-aside">
{% if display_github %}
<a href="https://github.com/{{ github_user }}/{{ github_repo }}/blob/{{ github_version }}{{ conf_py_path }}{{ pagename }}.rst" class="fa fa-github"> Edit on GitHub</a>
{% elif display_bitbucket %}
<a href="https://bitbucket.org/{{ bitbucket_user }}/{{ bitbucket_repo }}/src/{{ bitbucket_version}}{{ conf_py_path }}{{ pagename }}.rst" class="fa fa-bitbucket"> Edit on Bitbucket</a>
{% elif show_source and has_source and sourcename %}
<a href="{{ pathto('_sources/' + sourcename, true)|e }}" rel="nofollow"> View page source</a>
{% endif %}
</li>
</ul>
<hr/>
</div>
32 changes: 32 additions & 0 deletions doc/_themes/sphinx_rtd_theme/footer.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
<footer>
{% if next or prev %}
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
{% if next %}
<a href="{{ next.link|e }}" class="btn btn-neutral float-right" title="{{ next.title|striptags|e }}"/>Next <span class="fa fa-arrow-circle-right"></span></a>
{% endif %}
{% if prev %}
<a href="{{ prev.link|e }}" class="btn btn-neutral" title="{{ prev.title|striptags|e }}"><span class="fa fa-arrow-circle-left"></span> Previous</a>
{% endif %}
</div>
{% endif %}

<hr/>

<div role="contentinfo">
<p>
{%- if show_copyright %}
{%- if hasdoc('copyright') %}
{% trans path=pathto('copyright'), copyright=copyright|e %}&copy; <a href="{{ path }}">Copyright</a> {{ copyright }}.{% endtrans %}
{%- else %}
{% trans copyright=copyright|e %}&copy; Copyright {{ copyright }}.{% endtrans %}
{%- endif %}
{%- endif %}

{%- if last_updated %}
{% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %}
{%- endif %}
</p>
</div>

{% trans %}<a href="https://github.com/snide/sphinx_rtd_theme">Sphinx theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>{% endtrans %}
</footer>
160 changes: 160 additions & 0 deletions doc/_themes/sphinx_rtd_theme/layout.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,160 @@
{# TEMPLATE VAR SETTINGS #}
{%- set url_root = pathto('', 1) %}
{%- if url_root == '#' %}{% set url_root = '' %}{% endif %}
{%- if not embedded and docstitle %}
{%- set titlesuffix = " &mdash; "|safe + docstitle|e %}
{%- else %}
{%- set titlesuffix = "" %}
{%- endif %}

<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
{% block htmltitle %}
<title>{{ title|striptags|e }}{{ titlesuffix }}</title>
{% endblock %}

{# FAVICON #}
{% if favicon %}
<link rel="shortcut icon" href="{{ pathto('_static/' + favicon, 1) }}"/>
{% endif %}

{# CSS #}
<link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'>

{# OPENSEARCH #}
{% if not embedded %}
{% if use_opensearch %}
<link rel="search" type="application/opensearchdescription+xml" title="{% trans docstitle=docstitle|e %}Search within {{ docstitle }}{% endtrans %}" href="{{ pathto('_static/opensearch.xml', 1) }}"/>
{% endif %}

{% endif %}

{# RTD hosts this file, so just load on non RTD builds #}
{% if not READTHEDOCS %}
<link rel="stylesheet" href="{{ pathto('_static/' + style, 1) }}" type="text/css" />
{% endif %}

{% for cssfile in css_files %}
<link rel="stylesheet" href="{{ pathto(cssfile, 1) }}" type="text/css" />
{% endfor %}

{%- block linktags %}
{%- if hasdoc('about') %}
<link rel="author" title="{{ _('About these documents') }}"
href="{{ pathto('about') }}"/>
{%- endif %}
{%- if hasdoc('genindex') %}
<link rel="index" title="{{ _('Index') }}"
href="{{ pathto('genindex') }}"/>
{%- endif %}
{%- if hasdoc('search') %}
<link rel="search" title="{{ _('Search') }}" href="{{ pathto('search') }}"/>
{%- endif %}
{%- if hasdoc('copyright') %}
<link rel="copyright" title="{{ _('Copyright') }}" href="{{ pathto('copyright') }}"/>
{%- endif %}
<link rel="top" title="{{ docstitle|e }}" href="{{ pathto('index') }}"/>
{%- if parents %}
<link rel="up" title="{{ parents[-1].title|striptags|e }}" href="{{ parents[-1].link|e }}"/>
{%- endif %}
{%- if next %}
<link rel="next" title="{{ next.title|striptags|e }}" href="{{ next.link|e }}"/>
{%- endif %}
{%- if prev %}
<link rel="prev" title="{{ prev.title|striptags|e }}" href="{{ prev.link|e }}"/>
{%- endif %}
{%- endblock %}
{%- block extrahead %} {% endblock %}

{# Keep modernizr in head - http://modernizr.com/docs/#installing #}
<script src="https://cdnjs.cloudflare.com/ajax/libs/modernizr/2.6.2/modernizr.min.js"></script>

</head>

<body class="wy-body-for-nav" role="document">

<div class="wy-grid-for-nav">

{# SIDE NAV, TOGGLES ON MOBILE #}
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-nav-search">
<a href="{{ pathto(master_doc) }}" class="fa fa-home"> {{ project }}</a>
{% include "searchbox.html" %}
</div>

<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
{% set toctree = toctree(maxdepth=2, collapse=False, includehidden=True) %}
{% if toctree %}
{{ toctree }}
{% else %}
<!-- Local TOC -->
<div class="local-toc">{{ toc }}</div>
{% endif %}
</div>
&nbsp;
</nav>

<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">

{# MOBILE NAV, TRIGGLES SIDE NAV ON TOGGLE #}
<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="{{ pathto(master_doc) }}">{{ project }}</a>
</nav>


{# PAGE CONTENT #}
<div class="wy-nav-content">
<div class="rst-content">
{% include "breadcrumbs.html" %}
<div role="main">
{% block body %}{% endblock %}
</div>
{% include "footer.html" %}
</div>
</div>

</section>

</div>
{% include "versions.html" %}

{% if not embedded %}

<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'{{ url_root }}',
VERSION:'{{ release|e }}',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'{{ '' if no_search_suffix else file_suffix }}',
HAS_SOURCE: {{ has_source|lower }}
};
</script>
{%- for scriptfile in script_files %}
<script type="text/javascript" src="{{ pathto(scriptfile, 1) }}"></script>
{%- endfor %}

{% endif %}

{# RTD hosts this file, so just load on non RTD builds #}
{% if not READTHEDOCS %}
<script type="text/javascript" src="{{ pathto('_static/js/theme.js', 1) }}"></script>
{% endif %}

{# STICKY NAVIGATION #}
{% if theme_sticky_navigation %}
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.StickyNav.enable();
});
</script>
{% endif %}

{%- block footer %} {% endblock %}

</body>
</html>
Loading

0 comments on commit 8c5c319

Please sign in to comment.