Browse files

- Updated Pyramid docs with latest revisions

- Update readme with better instructions
- gitignore my personal notes
  • Loading branch information...
stevepiercy committed Nov 9, 2014
1 parent 51a7896 commit f4fdb963671d06b1376f797232fa29c7382aa0c5
Showing with 44 additions and 9 deletions.
  1. +1 −0 .gitignore
  2. +43 −9 docsets/Pyramid/
@@ -7,3 +7,4 @@
# Pods/
@@ -1,23 +1,57 @@
Pyramid is a small, fast Python web framework. It is developed as part of the [Pylons Project]( It is licensed under a [BSD-like license](
Steve Piercy
* [](
* [@steve_piercy](
Generate docset
##Generate docset
To generate the Pyramid docset for Dash:
1. [Generate the docs for Pyramid using Sphinx](
1. Follow the instructions for [Python, Sphinx or PyDoctor-Generated Documentation](
1. Follow the instructions for [Python, Sphinx or PyDoctor-Generated Documentation]( These instructions are general, so see the Tips below for additional help.
It's assumed that you have built the docs for Pyramid, installed doc2dash, forked and cloned the `Dash-User-Contributions` repository, and are using Mac OS X.
###Add built Pyramid docs to Dash app
Add the built Pyramid docs as a docset to the Dash application. `-f` forces an overwrite. `-i` adds an icon to the docset.
/path/to/doc2dash -A -n Pyramid -d /path/to/cloned/repo/Dash-User-Contributions/docsets/Pyramid -f -i /path/to/cloned/repo/Dash-User-Contributions/docsets/Pyramid/icon.png /path/to/cloned/pyramid/repo/docs/_build/html
###Copy the larger icon to the Dash.docset
cp /path/to/cloned/repo/Dash-User-Contributions/docsets/Pyramid/icon@2x.png /Users/USERNAME/Library/Application\ Support/doc2dash/DocSets/Pyramid.docset/icon@2x.png
###tar up the docset for a pull request
cd /Users/USERNAME/Library/Application\ Support/doc2dash/DocSets
tar --exclude='.DS_Store' -cvzf Pyramid.tgz Pyramid.docset
### move the archived docset into your local repo
mv Pyramid.tgz /path/to/cloned/repo/Dash-User-Contributions/docsets/Pyramid/Pyramid.tgz
###Share the archive
Commit your changes, push to your repository, and submit a pull request.
[Report an issue on GitHub](

0 comments on commit f4fdb96

Please sign in to comment.