Source

blog /

Filename Size Date modified Message
content
static
templates
8 B
1.4 KB
2.6 KB
238 B
This is the repository that the yt Project's blog is held in.

How to Add a Blog Entry
=======================

Simply create a new .rst file in ``content/post/``, with the extension
``.rst``.  The file doesn't need to have any prefixes; the old blog entries do
simply because that helped organize them.

Then, submit a pull request.

How to Add an IPython Notebook
==============================

First, download the nbconvert repository from the IPython project.  Place that
directory in your path.

Then, from the root of this blohg directory, run:

  python2.7 blohg_converterer.py --post-name "Your Post Name" /path/to/notebook.ipynb

This will upload a copy of your notebook to the Hub as well as converting it to
ReST, along with all of its attachments.  Then to add it to the blog, with its
files,

  hg ci -A

which will add any new files that are found in the repository's path.

What Manages The Blog
=====================

This blog is managed by the software ``blohg`` ( blohg.org ) which handles
versioning in a mercurial repository.  On top of that, it uses Shining Panda
and Amazon's S3 to automatically publish new entries that get pushed to the
main repository.

How Do I View My Blog Locally
=============================

First, ensure you have blohg installed::

   pip install -U blohg

Once you have committed your new file to the repository, run::

   blohg runserver

and go to the URL it spits out.  This will show you your new blog entry.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.