Tool to generate a dynamic version of a firefox "homepage" with tag cloud of bookmarks and a backlog
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
parts
.gitignore
COPYING
Makefile
README.md
_jade_tpl_render.py
ffhomegen.py

README.md

firefox-homepage-generator

Tool to generate a dynamic version of a firefox "homepage" with tag cloud of bookmarks and a random selection of backlog ("read later") links.

Templates and static assets in the "parts" directory will be used to construct result in one of a few ways:

  • Build one "fat" html file with all the assets embedded in it.

  • Build html file and copy it along with separate static "assets" files into a target directory.

  • Produce a single "lean" html file with asset links to various external CDN sources (kinda bad idea, TODO).

Difference between these is caching, but likely irrelevant when loaded from a local disk anyway.

Usage

Doesn't need to be "installed" - just put the contents of the repo/package anywhere, run the script to generate the page (and/or copy/link assets) in the output path (configurable via --output-path, see also --output-format).

Examples:

% ./ffhomegen.py
% ./ffhomegen.py -o ~/media/ffhome.html
% ./ffhomegen.py -f dir -o ~/media/ffhome
% ./ffhomegen.py -b ~/media/links.yaml
% firefox $(./ffhomegen.py -v)
% ./ffhomegen.py --help

Requirements

  • Python 2.7 (not 3.X)
  • (optional) yaml for parsing of "backlog" file

See http://pip2014.com/ for help with python modules' packaging.

To rebuild *.coffee, *.scss and *.jade files (not needed to just run the thing), any suitable compiler for these formats can be used. I use node-based coffee-script, libsass, pyjade + jinja2. Just typing "make" should do it with all these installed.

Links