{ "info": { "author": "Honza Pokorny", "author_email": "me@honza.ca", "bugtrack_url": null, "classifiers": [], "description": "===============================================================================\nSocrates\n===============================================================================\n\nSocrates is a simple static site generator. It's geared towards blogs. You\nwrite your posts in your favorite plain text to HTML language (e.g. Markdown,\ntextile, reStructuredText) and save them as text files on your harddrive.\nSocrates then takes them, and creates a full HTML site for you. For free, you\nwill get a home page which lists latest posts, single post pages, category\npages, archive pages, an about page and an atom feed.\n\nFeatures\n-------------------------------------------------------------------------------\n\n* Familiar Django and Jinja2 templates\n* Simple install via pip\n* Markdown, reStructuredText, Textile support\n* YAML configuration\n* Atom feed\n* Github pages compatible\n* Real HTML punctuation\n\nUsage\n-------------------------------------------------------------------------------\n\nFirst, you need to create a new blog::\n\n $ socrates -i blog\n\nThis will create a ``blog`` directory with a simple blog structure::\n\n blog\n posts\n 2010-your-post.md\n pages\n about.md\n contact.md\n layout\n index.html\n single.html\n category.html\n ...\n media\n style.css\n config.yaml\n\nThe ``posts`` directory is where you will place your posts files. Anything\nprefixed with ``_`` or ``.`` will be ignored. ``layout`` is your basic theme or\na template. ``config.yaml`` is a site-wide configuration file. Don't forget to\nupdate the about file with relevant information.\n\nYou can also create a new blog in the current working directory::\n\n $ socrates -i\n\nWhen you are ready to generate your site, you run::\n\n $ socrates -g blog\n\nOr, ::\n\n $ socrates -g\n\nfor current directory.\n\nThis will place all the generated files in ``blog/deploy``. You can then take\nthat directory and upload it to your server.\n\nInstallation\n-------------------------------------------------------------------------------\n\nFirst, set up your virtual environment and pip install Socrates.\n\n::\n\n virtualenv env --no-site-packages\n source env/bin/activate\n pip install socrates\n\nOr, to get the latest code, you can install from Github or Bitbucket.\n\n::\n\n pip install -e git://github.com/honza/socrates.git#egg=socrates\n\nThe next step is to install your templates. At the moment, you can choose\nbetween `Django templates`_ and `Jinja2 templates`_. The default theme uses\nDjango.\n\nThemes\n-------------------------------------------------------------------------------\n\nSocrates supports Django templates and Jinja2 templates. You can specify which\ntemplating engine you wish to use in the ``config.yaml`` file. There are two\nbasic themes in the ``themes`` directory to get you started.\n\nText to HTML\n-------------------------------------------------------------------------------\n\nSocrates will attemp to convert your text files into HTML using a text\nprocessor. You should specify the name of the text processor in\n``config.yaml``. It should be all lowercase. Currently supported processors:\n\n - Markdown\n - Textile\n - reStructuredText\n - HTML (unmodified text)\n\nDevelopment\n-------------------------------------------------------------------------------\n\nYou can start a simple development server to aid you in development.::\n\n $ socrates -r blog\n\nOr, ::\n\n $ socrates -r\n\nfor current directory.\n\nDuring development and/or composing a layout theme, it might be useful to always re-generate all posts, without caching.\nTo do so, you can run the following option: ::\n\n $ socrates -c\n\n\nDocumentation\n-------------------------------------------------------------------------------\n\nThe documentation is contained within the ``docs`` directory and is written in\nreStructuredText using `Sphinx`_. The documentation is easily read in a\nstandard text editor. However, you can build an HTML version like so::\n\n $ pip install sphinx\n $ cd docs/\n $ make html\n $ open _build/html/index.html\n\nOr, you can view the online version of the latest `documentation`_.\n\n\nLicense\n-------------------------------------------------------------------------------\n\nSocrates is licensed under the terms of the 3-clause BSD license.\n\nContribute\n-------------------------------------------------------------------------------\n\nAll contributions are welcome. Please do ask if a feature is wanted before\nstarting work to avoid wasting your time.\n\nBugs & Issues\n-------------------------------------------------------------------------------\n\nPlease report all bugs on Github. `Mailing list`_. You can also come visit us\nin ``#socrates`` on freenode.\n\nAuthors\n-------------------------------------------------------------------------------\n\nSocrates was originally written by Honza Pokorny. For a complete list of\nauthors, please see the AUTHORS file.\n\nIn the wild\n-------------------------------------------------------------------------------\n\n* `Honza's blog `_\n* `Adam's blog `_\n\n.. _Django templates: https://docs.djangoproject.com/en/1.3/#the-template-layer\n.. _Jinja2 templates: http://jinja.pocoo.org/docs/\n.. _Sphinx: http://sphinx.pocoo.org/\n.. _documentation: http://readthedocs.org/docs/socrates/en/latest/index.html\n.. _Mailing list: https://groups.google.com/group/python-socrates", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://honza.github.com/socrates/", "keywords": null, "license": "UNKNOWN", "maintainer": null, "maintainer_email": null, "name": "socrates", "package_url": "https://pypi.org/project/socrates/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/socrates/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://honza.github.com/socrates/" }, "release_url": "https://pypi.org/project/socrates/0.9.3/", "requires_dist": null, "requires_python": null, "summary": "Socrates is a simple static site generator.", "version": "0.9.3" }, "last_serial": 2024775, "releases": { "0.5.0": [], "0.6.0": [], "0.6.1": [ { "comment_text": "", "digests": { "md5": "1c6d6a86f046aeb86f192d1671fbeec8", "sha256": "4d314790f608c4617e90d751830d5a961e0f118bbc91c302d13a60bf39abc374" }, "downloads": -1, "filename": "socrates-0.6.1.tar.gz", "has_sig": false, "md5_digest": "1c6d6a86f046aeb86f192d1671fbeec8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12539, "upload_time": "2011-09-07T21:44:52", "url": "https://files.pythonhosted.org/packages/86/a0/0ca18700ff70a418d96816435280188c7468c826720194b64916fe7f14bd/socrates-0.6.1.tar.gz" } ], "0.6.2": [ { "comment_text": "", "digests": { "md5": "983b2799d7d077b57c63a8a392abc0c8", "sha256": "7f343dd71d86794f6cc8f91a735630e95f00a2ee05b30164cb3a724818b6ca94" }, "downloads": -1, "filename": "socrates-0.6.2.tar.gz", "has_sig": false, "md5_digest": "983b2799d7d077b57c63a8a392abc0c8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14508, "upload_time": "2011-09-07T21:51:39", "url": "https://files.pythonhosted.org/packages/a2/72/bc29ab58c425ec52b90d282f21ee00fae569d416b1323d7d11987fcb17a4/socrates-0.6.2.tar.gz" } ], "0.6.3": [ { "comment_text": "", "digests": { "md5": "aec23a39610a04f616b7a34036d635c0", "sha256": "eac91675a29a2a50b1a1f9bd8f718f59e222b43671aa255ed6b28c92305d84e6" }, "downloads": -1, "filename": "socrates-0.6.3.tar.gz", "has_sig": false, "md5_digest": "aec23a39610a04f616b7a34036d635c0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12250, "upload_time": "2011-09-07T21:54:58", "url": "https://files.pythonhosted.org/packages/ad/c9/07af1c993b4da180abb5c538fd46e06090324b04075f02dc8fba9e7d4846/socrates-0.6.3.tar.gz" } ], "0.6.4": [ { "comment_text": "", "digests": { "md5": "e8788f4c3348f80d454886747a759857", "sha256": "5832ad8dd78d2107be17ddf8f739861102fe920104bcc7e17ff75042676cb25d" }, "downloads": -1, "filename": "socrates-0.6.4.tar.gz", "has_sig": false, "md5_digest": "e8788f4c3348f80d454886747a759857", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14463, "upload_time": "2011-09-07T22:06:31", "url": "https://files.pythonhosted.org/packages/11/41/1c972988734992fbc241304cc2e260137ca191b8c7cdca0d952e2d33512e/socrates-0.6.4.tar.gz" } ], "0.7.0": [ { "comment_text": "", "digests": { "md5": "562564154477caa631fe85baa89d208b", "sha256": "6f5402e36a548d777a7e110e517ae7d7de82aad381fdd5602460f96bd7ffdecc" }, "downloads": -1, "filename": "socrates-0.7.0.tar.gz", "has_sig": false, "md5_digest": "562564154477caa631fe85baa89d208b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17826, "upload_time": "2012-01-24T15:50:39", "url": "https://files.pythonhosted.org/packages/44/e8/60c5f204a1b6c381b32e9244ac3175a5537dee9263a2384cc2621a634b2c/socrates-0.7.0.tar.gz" } ], "0.8.0": [], "0.9.0": [ { "comment_text": "", "digests": { "md5": "c7ffa6d864b427438b162aea96b07c7c", "sha256": "81dba2f9784df7bf6665147cc170711d008890f3d39f598985691cb63874f6ea" }, "downloads": -1, "filename": "socrates-0.9.0.tar.gz", "has_sig": false, "md5_digest": "c7ffa6d864b427438b162aea96b07c7c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 31691, "upload_time": "2013-07-26T12:59:31", "url": "https://files.pythonhosted.org/packages/ce/7b/417adc0d051314312796b2a8d9bbda42482f41799dc7e5b85ca133ee0c7c/socrates-0.9.0.tar.gz" } ], "0.9.1": [ { "comment_text": "", "digests": { "md5": "62b8f1f395d4e4620b0d63e53251c167", "sha256": "563441e8238267364387263e981602eefd4dabcd92e5ed0550b322934dca157b" }, "downloads": -1, "filename": "socrates-0.9.1.tar.gz", "has_sig": false, "md5_digest": "62b8f1f395d4e4620b0d63e53251c167", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 32032, "upload_time": "2015-11-12T15:22:11", "url": "https://files.pythonhosted.org/packages/62/79/fb4b225382724042f5654cc2f26c2499068996fc1dac454da844f5aa926a/socrates-0.9.1.tar.gz" } ], "0.9.2": [ { "comment_text": "", "digests": { "md5": "7a43622117f76769cb070f762b7aaff2", "sha256": "5d0b428d8ae54178bf642cf6b99fd95decf50a4550255622e6660676ececfe96" }, "downloads": -1, "filename": "socrates-0.9.2.tar.gz", "has_sig": false, "md5_digest": "7a43622117f76769cb070f762b7aaff2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 32110, "upload_time": "2016-03-01T15:15:24", "url": "https://files.pythonhosted.org/packages/0d/2f/7ffdc10fe448e4e2dcfb1623adc3d5c942a910cef0599c428d3af3f64c39/socrates-0.9.2.tar.gz" } ], "0.9.3": [ { "comment_text": "", "digests": { "md5": "d1b12a7e34fc63b4547890e8701f4cf4", "sha256": "1ac1156bdc9d16db25261ba898a023f8c6848f356e11b6ad107294e73f2c911e" }, "downloads": -1, "filename": "socrates-0.9.3.tar.gz", "has_sig": false, "md5_digest": "d1b12a7e34fc63b4547890e8701f4cf4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 29497, "upload_time": "2016-03-24T12:31:19", "url": "https://files.pythonhosted.org/packages/5d/ef/8f3c91615b4f1a6676719d0dc150cd6c74eef5dec47f944915bde526f091/socrates-0.9.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "d1b12a7e34fc63b4547890e8701f4cf4", "sha256": "1ac1156bdc9d16db25261ba898a023f8c6848f356e11b6ad107294e73f2c911e" }, "downloads": -1, "filename": "socrates-0.9.3.tar.gz", "has_sig": false, "md5_digest": "d1b12a7e34fc63b4547890e8701f4cf4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 29497, "upload_time": "2016-03-24T12:31:19", "url": "https://files.pythonhosted.org/packages/5d/ef/8f3c91615b4f1a6676719d0dc150cd6c74eef5dec47f944915bde526f091/socrates-0.9.3.tar.gz" } ] }