{ "info": { "author": "Chris Pressey", "author_email": "packages@catseye.tc", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Information Technology", "License :: Public Domain", "Operating System :: OS Independent", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3" ], "description": "Feedmark\n========\n\n*Version 0.9-2019.1015. Subject to change in backwards-incompatible ways without notice.*\n\n**Feedmark** is a format for embedding structured data in Markdown files\nin a way which is both human-readable and machine-extractable.\nThe structured data is intended to be \"curational\" in nature.\nArticles in [Chrysoberyl][] and [The Dossier][] are written in Feedmark.\n\nInformally, the format says that every `h3`-level heading in the\nMarkdown file gives the title of an entity, and may be followed\nimmediately by the entity's \"plaque\", which is a bullet list\nwhere every item is in the form \"field-name: field-value\".\n\nWhy Feedmark?\n-------------\n\nIn the same way that a Markdown file is still a readable text file,\nwhich is nice, a Feedmark file is still a readable Markdown file,\nwhich is still a readable text file, which is nice.\n\nWhile some structured data formats like YAML are fairly easy to\nread, many web-based files viewers (such as GitHub's) will\nautomatically format Markdown as HTML, making it that much nicer.\n\nExample Feedmark documents can be found in the `eg/` directory,\nand in the projects mentioned above.\n\nImplementation\n--------------\n\nThis repository contains a Python program, `feedmark`, which is a\nreference implementation of a processor for the Feedmark format.\n\nTo use it, you can clone this repository and run it as `bin/feedmark`\nfrom the directory of your clone, or you can put the `bin` directory\non your executable search path, and run it as `feedmark` anywhere.\n\nOr you can install it using `pip`:\n\n pip install Feedmark==0.9.2019.1015\n\n(Depending on your needs, you may wish to establish a virtual environment\nfirst. How to do this is outside the scope of this document.)\n\n`feedmark` is currently able to do the following things:\n\n### Parse and check Feedmark documents\n\nLoading documents will always check that they are minimally well-formed.\n\n feedmark eg/*.md\n\nYou can also check documents against a Feedmark schema, which is\nsimply another Feedmark document, one in which each entry describes\na property that entries should have.\n\n feedmark eg/*Sightings*.md --check-against=eg/schema/Llama\\ sighting.md\n\n### Convert Feedmark documents to various formats\n\nThe original use case of this tool was to generate an Atom (n\u00e9e RSS)\nfeed of entries in a document:\n\n feedmark \"eg/Recent Llama Sightings.md\" --output-atom=feed.xml\n python -m SimpleHTTPServer 7000 &\n python -m webbrowser http://localhost:7000/feed.xml\n\nIt can now also output entries as JSON, indexed by entry, or by\nproperty, or by publication date:\n\n feedmark --output-json eg/*.md\n feedmark --by-property eg/*.md\n feedmark --by-publication-date eg/*.md\n\nOutput entries as Markdown, or HTML (using the `toc` extension,\nwhich generates link anchors on headings compatible with the ones\ngenerated by GitHub).\n\n feedmark --output-markdown eg/*.md\n feedmark --output-html eg/*.md\n\n### Rewrite documents in-place\n\nThey will be parsed as Feedmark, and then output as Markdown, to the\nsame files that were read in as input. (Note! This is destructive;\nit is recommended that the original files be under version control such\nas `git`, which will easily allow the changes to be reverted if necessary.)\n\n feedmark --rewrite-markdown eg/*.md\n\n### Interlink documents\n\nMarkdown supports \"reference-style\" links, which are not inline\nwith the text.\n\n`feedmark` can rewrite reference-style links that match the name of\nan entry in a previously-created \"refdex\", so that they\ncan be kept current and point to the canonical document in which the\nentry exists, since it may exist in multiple, or be moved over time.\n\n feedmark eg/*.md --output-refdex >refdex.json\n feedmark --input-refdex=refdex.json --rewrite-markdown eg/*.md\n\nSee also\n--------\n\nFeedmark is a subset of Markdown, which is something it has in common\nwith [Falderal][], however it has decidedly different goals.\n\nTODO\n----\n\nResearch whether JSON Schema could be used for validation as well.\n\n\"common\" properties on document which all entries within inherit.\n\nSub-entries. Somehow. For individual games in a series, implementations\nor variations on a programming language, etc.\n\nAllow trailing `###` on h3-level headings.\n\nIndex creation from refdex, for permalinks.\n\n[Falderal]: http://catseye.tc/node/Falderal\n[Chrysoberyl]: http://git.catseye.tc/Chrysoberyl/\n[The Dossier]: http://git.catseye.tc/The-Dossier/\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://catseye.tc/node/Feedmark", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "Feedmark", "package_url": "https://pypi.org/project/Feedmark/", "platform": "", "project_url": "https://pypi.org/project/Feedmark/", "project_urls": { "Homepage": "https://catseye.tc/node/Feedmark" }, "release_url": "https://pypi.org/project/Feedmark/0.9.2019.1015/", "requires_dist": null, "requires_python": "", "summary": "Definition of Feedmark, a curation-oriented subset of Markdown, and tools for processing it", "version": "0.9.2019.1015" }, "last_serial": 5975642, "releases": { "0.9": [ { "comment_text": "", "digests": { "md5": "355836875fc90d5a2b5c21ec2c35823a", "sha256": "e43f5416d4488166f743d0ad2f3cc7127b80614304f40dbb666c4fd787061db3" }, "downloads": -1, "filename": "Feedmark-0.9-py3-none-any.whl", "has_sig": false, "md5_digest": "355836875fc90d5a2b5c21ec2c35823a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 13293, "upload_time": "2019-10-14T10:31:17", "url": "https://files.pythonhosted.org/packages/e2/b7/1035b3dac221bd27546936cc8d2c23e16bfb4c9a8b9a9e6755b216e6d714/Feedmark-0.9-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "d3896c12a5e658c439261a13dd6ac2a8", "sha256": "a438c67885f779f7dbac8a4bc16b1780d151a6af0b579cddcca9608bd23a6583" }, "downloads": -1, "filename": "Feedmark-0.9.tar.gz", "has_sig": false, "md5_digest": "d3896c12a5e658c439261a13dd6ac2a8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13341, "upload_time": "2019-10-14T10:31:19", "url": "https://files.pythonhosted.org/packages/2b/de/6e3e58091b09d031a35c7d6ab0cb95a268f6da191bac6aa7c081a5d87cda/Feedmark-0.9.tar.gz" } ], "0.9.2019.1015": [ { "comment_text": "", "digests": { "md5": "e22b30405bbacde32feb9fcd9a91d951", "sha256": "e12db949f0e7d836235bff3923054b919ae17f509c92d1f3f04d17a8d6cde09b" }, "downloads": -1, "filename": "Feedmark-0.9.2019.1015-py3-none-any.whl", "has_sig": false, "md5_digest": "e22b30405bbacde32feb9fcd9a91d951", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 15378, "upload_time": "2019-10-15T08:47:08", "url": "https://files.pythonhosted.org/packages/4a/8f/cf6cdedc6e9b5d78dbf9fa0043568374cb598d19cb34ccce4cd4137d7de7/Feedmark-0.9.2019.1015-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1415f85bc8cb34ae829a999f50fc97a7", "sha256": "23566eedcccdfb1f93c5a614fd70f398fc59ce7cbb7ba8325408429d37a932f1" }, "downloads": -1, "filename": "Feedmark-0.9.2019.1015.tar.gz", "has_sig": false, "md5_digest": "1415f85bc8cb34ae829a999f50fc97a7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14510, "upload_time": "2019-10-15T08:47:12", "url": "https://files.pythonhosted.org/packages/33/42/51339c19e817a64c74c616ad3702e0eba2b81eed2e2febc77b1cb7a807bb/Feedmark-0.9.2019.1015.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "e22b30405bbacde32feb9fcd9a91d951", "sha256": "e12db949f0e7d836235bff3923054b919ae17f509c92d1f3f04d17a8d6cde09b" }, "downloads": -1, "filename": "Feedmark-0.9.2019.1015-py3-none-any.whl", "has_sig": false, "md5_digest": "e22b30405bbacde32feb9fcd9a91d951", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 15378, "upload_time": "2019-10-15T08:47:08", "url": "https://files.pythonhosted.org/packages/4a/8f/cf6cdedc6e9b5d78dbf9fa0043568374cb598d19cb34ccce4cd4137d7de7/Feedmark-0.9.2019.1015-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1415f85bc8cb34ae829a999f50fc97a7", "sha256": "23566eedcccdfb1f93c5a614fd70f398fc59ce7cbb7ba8325408429d37a932f1" }, "downloads": -1, "filename": "Feedmark-0.9.2019.1015.tar.gz", "has_sig": false, "md5_digest": "1415f85bc8cb34ae829a999f50fc97a7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14510, "upload_time": "2019-10-15T08:47:12", "url": "https://files.pythonhosted.org/packages/33/42/51339c19e817a64c74c616ad3702e0eba2b81eed2e2febc77b1cb7a807bb/Feedmark-0.9.2019.1015.tar.gz" } ] }