{ "info": { "author": "Vivek Ghaisas", "author_email": "", "bugtrack_url": null, "classifiers": [], "description": "Petroglyph\n==========\n[![Build Status](https://travis-ci.org/polybuildr/petroglyph.svg?branch=master)](https://travis-ci.org/polybuildr/petroglyph)\n\nPetroglyph is a Python-based static blog generator. (Tested on 2.7.6).\n\n## Installation\n\nPetroglyph is now a pip package! You can install petroglyph by simply doing:\n```bash\n$ sudo pip install petroglyph\n```\n\nIf you don't have `pip`, first install pip using your package manager.\n\n```bash\n$ sudo apt-get install python-pip #Ubuntu, etc.\n$ sudo yum install python-pip #Fedora, etc.\n```\nIf installing from `pip` doesn't work for you, please [file an issue](https://github.com/polybuildr/petroglyph/issues) and then use the old installation instructions below instead.\n\n### Old installation procedure\n\nTo install, first install `mistune`, `pyyaml` and `docutils`.\n\n```bash\n$ pip install mistune pyyaml docutils\n```\n\nIf you don't have `pip`, first install pip using your package manager.\n\n```bash\n$ sudo apt-get install python-pip #Ubuntu, etc.\n$ sudo yum install python-pip #Fedora, etc.\n```\n\nIf `pip` fails to install `pyyaml` (check for the line `Successfully installed pyyaml` in the output), then you can use your package manager to install `pyyaml`.\n\n```bash\n$ sudo apt-get install python-yaml #Ubuntu, etc.\n$ sudo yum install PyYAML #Fedora, etc.\n```\n\nNext, install petroglyph. Petroglyph is currently not available as a pip package, so you'll have to install it manually.\n\nYou can download a [stable release from GitHub](https://github.com/polybuildr/petroglyph/releases) or clone from master.\n\nThere is a script named `petroglyph` in the folder, this is the script you will use to set up your blog. Consider putting this in your `PATH` for ease of use.\n\nOn Linux, if using `bash`, you can add a line to your `.bashrc` to do this.\n\n```bash\n$ echo 'export PATH=\"/path/to/petroglyph:$PATH\"' >> ~/.bashrc\n$ source ~/.bashrc\n```\n\nDepending on your setup, this could be a different file, such as `~/.profile` or `~/.bash_profile`.\n\n## Setting up a blog\n\n1. Create a new directory for your blog.\n\n ```bash\n $ mkdir awesomeblog\n ```\n2. Inside this new directory, run `petroglyph init` and fill in the details.\n\n The default theme is `monoblue`. There used to be other skins, but they're no longer there. Hopefully, I'll add them in the future. Until then, you can always edit the CSS yourself amd make a custom skin!\n\n ```bash\n $ cd awesomeblog\n $ petroglyph init\n Copying skin 'monoblue'...\n Creating posts directory...\n Configuring settings...\n Blog title: Awesome Blog\n Blog author: John Doe\n Blog description: The awesome blog!\n Saved configuration in config.yaml.\n Petroglyph initialized.\n ```\n At any point if you want to replace your skin or change the configuration, run `petroglyph init` again.\n\n3. Write a new post in the `/posts` directory with a `.md` extension. (reStructuredText is also supported, give the file an `.rst` extension.) Each post's filename will be used as the post's slug when the blog is generated. Markdown support is provided using [Mistune](https://github.com/lepture/mistune). Include post metadata by writing posts as follows:\n\n ```\n ---\n title: The Post's Title\n tags: some-tag, another-tag\n ---\n Hello, world! **Bold**, _italics_ and `code`.\n\n This part will be before the 'Read more'.\n\n This part will come after the read more.\n ```\n > A post title is **required**.\n\n > Petroglyph uses the last modified time of a file when deciding the post publish date. If you'd like to use a custom date, add it to the metadata in the `YYYY-MM-DD` format.\n ```\n date: 2015-06-07\n ```\n4. Dry run petroglyph to see if everything works fine.\n ```bash\n $ petroglyph --dry-run\n Found 1 post.\n 1 new post.\n ```\n\n5. Run petroglyph!\n ```bash\n $ petroglyph\n Found 1 post.\n 1 new post.\n Generated 1 new post.\n Done.\n ```\n > If you ever want to regenerate all your pages (because of a theme change, for example), run `petroglyph --regenerate`.\n\n6. Your blog is ready to be served in the `blog/` directory.\n ![](http://polybuildr.github.io/petroglyph/screenshot.png)\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/polybuildr/petroglyph", "keywords": "static blog", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "petroglyph", "package_url": "https://pypi.org/project/petroglyph/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/petroglyph/", "project_urls": { "Homepage": "https://github.com/polybuildr/petroglyph" }, "release_url": "https://pypi.org/project/petroglyph/0.5.0/", "requires_dist": null, "requires_python": "", "summary": "A static blog generator", "version": "0.5.0" }, "last_serial": 1928211, "releases": { "0.2.0": [ { "comment_text": "", "digests": { "md5": "7e045e47972df684cbb70881fdef4ee4", "sha256": "9442044e943741df950eea18cd7e16eacf178847bf4d07524fb76a8883ca58ef" }, "downloads": -1, "filename": "petroglyph-0.2.0.zip", "has_sig": false, "md5_digest": "7e045e47972df684cbb70881fdef4ee4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 50547, "upload_time": "2015-06-26T20:59:05", "url": "https://files.pythonhosted.org/packages/40/f0/0667aff7d46eb9d8cd372ae4ea24eea1142c488fe3b2130ba2e6b64649be/petroglyph-0.2.0.zip" } ], "0.2.0.post1": [ { "comment_text": "", "digests": { "md5": "629914ee0febf09dc2789b641ae884f0", "sha256": "52177734dd65d5a4d8a64eb41a269414aef01b0fafdbc39ed96b2ff57586f398" }, "downloads": -1, "filename": "petroglyph-0.2.0.post1.tar.gz", "has_sig": false, "md5_digest": "629914ee0febf09dc2789b641ae884f0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 34329, "upload_time": "2015-06-26T21:06:08", "url": "https://files.pythonhosted.org/packages/0c/c1/1d7980c7a2c446c916212c4ee0ee34b1fdb022f0a0de52bd55b446590ef9/petroglyph-0.2.0.post1.tar.gz" } ], "0.2.0.post2": [ { "comment_text": "", "digests": { "md5": "96d1a9d4f2223f8b1f91c2c0966202fa", "sha256": "f1e3ab024cea612353520bdaae90ada70c9621235e13627b0653360517512423" }, "downloads": -1, "filename": "petroglyph-0.2.0.post2.tar.gz", "has_sig": false, "md5_digest": "96d1a9d4f2223f8b1f91c2c0966202fa", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 34358, "upload_time": "2015-06-26T21:07:06", "url": "https://files.pythonhosted.org/packages/c7/34/5ac4abcb39c0cfcd993364d087f595699f6ed916d5c493fe0dea91775d3d/petroglyph-0.2.0.post2.tar.gz" } ], "0.2.0.post3": [ { "comment_text": "", "digests": { "md5": "a9dc8a90a6649c22245753261c8202bf", "sha256": "a459de6217bfb0915cdfd43f371f3d5f6a1789221f2c2cde7e81b5df65bdd62c" }, "downloads": -1, "filename": "petroglyph-0.2.0.post3.tar.gz", "has_sig": false, "md5_digest": "a9dc8a90a6649c22245753261c8202bf", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 34358, "upload_time": "2015-06-26T21:08:12", "url": "https://files.pythonhosted.org/packages/81/97/b5d2d21dbce9fee83507ed43058c34533412c5eaf331d5e723234232239a/petroglyph-0.2.0.post3.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "990d05224781901bd7a950f8e09661f8", "sha256": "e9bf8a831dbc5a3520c8a1d89c803d5642cefc68d47a5e4fb299640477d7b883" }, "downloads": -1, "filename": "petroglyph-0.3.0.tar.gz", "has_sig": false, "md5_digest": "990d05224781901bd7a950f8e09661f8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 35894, "upload_time": "2015-06-26T21:16:36", "url": "https://files.pythonhosted.org/packages/fc/5d/8e9b59262d11077759e5e7cfa15435f2c88b0b469b82c3e7dc65348e6d4c/petroglyph-0.3.0.tar.gz" } ], "0.4.0": [ { "comment_text": "", "digests": { "md5": "ad8a2bf675c5aaac69052c0d4d5cbce7", "sha256": "d35f0e227d7b8c5fba73459f581f93db98ad093bbc38255aad7fcb65908d8e99" }, "downloads": -1, "filename": "petroglyph-0.4.0.tar.gz", "has_sig": false, "md5_digest": "ad8a2bf675c5aaac69052c0d4d5cbce7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15789, "upload_time": "2015-07-06T18:32:29", "url": "https://files.pythonhosted.org/packages/00/89/1f579c768383f4e2874dbfba8ffb23b01b8ebe061dd1a2b0c17848a2a1ad/petroglyph-0.4.0.tar.gz" } ], "0.4.1": [ { "comment_text": "", "digests": { "md5": "c86a829dd359fbcd870f75fd44f987c7", "sha256": "61c51ecd0f91ecceca072bbd60236c62bd4041666bb03a06777160fc0bc06978" }, "downloads": -1, "filename": "petroglyph-0.4.1.tar.gz", "has_sig": false, "md5_digest": "c86a829dd359fbcd870f75fd44f987c7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15779, "upload_time": "2015-07-06T20:28:04", "url": "https://files.pythonhosted.org/packages/a1/89/d2fdccca111507ed1f5b4f4cb9dfc2c200769188637502fae32aa894e3bf/petroglyph-0.4.1.tar.gz" } ], "0.5.0": [ { "comment_text": "", "digests": { "md5": "d7b8a66b0eb3c85840d6648b6e139bd1", "sha256": "a0b2dea7cfdd75e383e68b085b0614d2bb3fee020e17257888e34aad063775a2" }, "downloads": -1, "filename": "petroglyph-0.5.0.tar.gz", "has_sig": false, "md5_digest": "d7b8a66b0eb3c85840d6648b6e139bd1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16011, "upload_time": "2016-01-28T22:33:09", "url": "https://files.pythonhosted.org/packages/f9/76/698d57089b6ea42305a203927587fd5edfdb784ef94015e91d4653f74b60/petroglyph-0.5.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "d7b8a66b0eb3c85840d6648b6e139bd1", "sha256": "a0b2dea7cfdd75e383e68b085b0614d2bb3fee020e17257888e34aad063775a2" }, "downloads": -1, "filename": "petroglyph-0.5.0.tar.gz", "has_sig": false, "md5_digest": "d7b8a66b0eb3c85840d6648b6e139bd1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16011, "upload_time": "2016-01-28T22:33:09", "url": "https://files.pythonhosted.org/packages/f9/76/698d57089b6ea42305a203927587fd5edfdb784ef94015e91d4653f74b60/petroglyph-0.5.0.tar.gz" } ] }