{ "info": { "author": "Nathan R. Yergler", "author_email": "nathan@yergler.net", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: BSD License", "Programming Language :: Python :: 2", "Programming Language :: Python :: 3", "Topic :: Documentation", "Topic :: Text Processing" ], "description": "==========\n Cascajal\n==========\n\n**Cascajal** is a script which automates generating PDFs from Hieroglyph_\npresentations using Firefox_.\n\nHow It Works\n============\n\nHieroglyph_ generates HTML presentations from `Restructured Text`_\ndocuments. Sometimes, however, you need a PDF. For the conference\norganizer, `Speaker Deck`_, etc. **Cascajal** automates generating\nthat PDF using Firefox.\n\nInstalling\n==========\n\nYou can install Cascajal using pip_::\n\n $ pip install --user cascajal\n\nNote that you'll need to have the user binary directory on your PATH;\nsee `pip 2014`_ if you need help with that.\n\nCascajal doesn't have any external Python dependencies. It does depend\non Firefox (or Iceweasel_, or something Firefox-like).\n\nGenerating PDFs\n===============\n\nAfter you've installed Cascajal, you can generate a PDF of your\nslides.\n\n::\n\n $ make slides # this runs Hieroglyph; see the Hieroglyph docs\n $ cascajal -o slides.pdf ./_build/slides/index.html\n\nCascajal will create a temporary Firefox profile, launch the browser,\nand print to a PDF. After printing completes, you can close the\nbrowser, or Cascajal will do it for you after a few seconds.\n\nYou'll get something like\nhttps://speakerdeck.com/nyergler/in-depth-pdb as output.\n\nWait, but...\n============\n\n* My slides aren't rendering correctly!!\n\n What theme are you using? Cascajal works best with the slides2_\n theme in Hieroglyph. ``slides`` and ``single-level`` both have some\n known issues; your mileage may vary.\n\n* How does Cascajal find Firefox on my system?\n\n Poorly.\n\n Right now it looks in a couple of common places where it might be\n installed on Linux. At some point I'll add common places for Mac\n OS X. I'd love it if someone using Windows helped make detection\n work there.\n\n* Why Firefox?\n\n Of the tools I tried, Firefox came the closest to working \"out of\n the box\". Cascajal just tries to smooth over all the settings\n (documented and otherwise) that you need to set to make it work.\n\n* What not PhantomJS_\\ ?\n\n Phantom currently does not support web fonts. So while it does an\n *amazing* job of generating in a headless fashion, even simple\n things like monospace fonts render incorrectly.\n\n PhantomJS 2 is currently under development, and should include\n improved support for web fonts. It's not hard to imagine a Cascajal\n of the future that uses Phantom, and works even better.\n\n* How can I help?\n\n Try it out, let me know what doesn't work!\n\n See ``HACKING.rst`` for information on how to edit the code.\n\n* What's up with the name?\n\n According to Wikipedia,\n\n The `Cascajal Block`_ is a tablet-sized writing slab made of serpentinite\n from Mexico which has been dated to the early first millennium BCE,\n incised with hitherto unknown characters that may represent the\n earliest writing system in the New World.\n\n So Cascajal is a writing slab for your Hieroglyphs.\n\n.. _Hieroglyph: http://hieroglyph.io/\n.. _Firefox: http://www.mozilla.org/en-US/firefox/\n.. _`Restructured Text`: http://docutils.sourceforge.net/\n.. _`Speaker Deck`: https://speakerdeck.com/\n.. _Iceweasel: http://www.geticeweasel.org/\n.. _PhantomJS: http://phantomjs.org/\n.. _pip: `pip 2014`_\n.. _`pip 2014`: http://pip2014.com/\n.. _`Cascajal Block`: http://en.wikipedia.org/wiki/Cascajal_Block\n.. _slides2: http://docs.hieroglyph.io/en/latest/themes.html#slides2\n\n\nNews\n====\n\n0.1\n---\n\n*Release date: UNRELEASED*", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/nyergler/cascajal", "keywords": "PDF presentation text-processing", "license": "BSD", "maintainer": null, "maintainer_email": null, "name": "cascajal", "package_url": "https://pypi.org/project/cascajal/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/cascajal/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/nyergler/cascajal" }, "release_url": "https://pypi.org/project/cascajal/0.1/", "requires_dist": null, "requires_python": null, "summary": "PDF generation for Hieroglyph presentations.", "version": "0.1" }, "last_serial": 1061469, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "5040c4e92c13033abc6d55a6fff8ffb3", "sha256": "846d6d727c89be2f730f26a3d76eb9c2b71f8b460693bcf5437c68a0957244da" }, "downloads": -1, "filename": "cascajal-0.1.tar.gz", "has_sig": false, "md5_digest": "5040c4e92c13033abc6d55a6fff8ffb3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14857, "upload_time": "2014-04-15T19:13:51", "url": "https://files.pythonhosted.org/packages/c9/d8/4cf71bf96951d3f63c276d3817b33a0b305d2ae15747d304b0fe4b8bf67e/cascajal-0.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "5040c4e92c13033abc6d55a6fff8ffb3", "sha256": "846d6d727c89be2f730f26a3d76eb9c2b71f8b460693bcf5437c68a0957244da" }, "downloads": -1, "filename": "cascajal-0.1.tar.gz", "has_sig": false, "md5_digest": "5040c4e92c13033abc6d55a6fff8ffb3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14857, "upload_time": "2014-04-15T19:13:51", "url": "https://files.pythonhosted.org/packages/c9/d8/4cf71bf96951d3f63c276d3817b33a0b305d2ae15747d304b0fe4b8bf67e/cascajal-0.1.tar.gz" } ] }