{ "info": { "author": "Philippe Morissette", "author_email": "morissette.philippe@gmail.com", "bugtrack_url": null, "classifiers": [], "description": ".. image:: http://pmorissette.github.io/klink/_static/logo.png\n\n\nklink - A Simple & Clean Sphinx Theme\n=====================================\n\nKlink is a **simple** and **clean** theme for creating `Sphinx docs\n`__. It is heavily inspired by the beautiful `jrnl theme\n`__. It also supports embedding `IPython\nNotebooks `__ which can be mighty useful.\n\nFor a live demo, please visit `our docs `__.\n\nOptions\n-------\n\nHere are the theme options. They should be added to the html_theme_options in\nyour **conf.py** file.\n\n* **github**\n The github address of the project. The format is name/project\n (pmorissette/klink).\n* **logo**\n The logo file. Assumed to be in the _static dir. Default is logo.png. The logo\n should be 150x150.\n* **analytics_id**\n Your Google Analytics id (usually starts with UA-...)\n\nIPython Notebook Integration\n----------------------------\n\nWith the klink helper function **convert_notebooks()**, all notebooks will be\nconverted to .rst so that they can be included in your docs. This includes all\noutput including images. It\u2019s a very convenient way to create Python docs! \n\nAll you have to do is create notebooks within your source directory (same directory\nas your conf.py file). Then, you add a call to klink.convert_notebooks() in your\nconf.py. You can also mix in **Mardown** cells or **Raw NBConvert** cells in\nyour workbook. These will be converted to rst as well. \n\nIf you use the Raw NBConvert type cells, add a blank line at the start. There\nseems to be a bug in the rst conversion and if the cell does not begin with a\nblank line, you may run into some issues. \n\nUsing a Raw NBConvert cell with rst text inside is convenient, especially if you\nwant to have links to other parts of your Sphinx docs. \n\nInstallation\n------------\n\nAssuming you have pip installed:\n\n.. code:: sh\n\n $ pip install klink\n\nThat's it.\n\nUsage\n-----\n\nIn your docs' **conf.py** file, add the following:\n\n.. code:: python\n\n import klink\n\n html_theme = 'klink'\n html_theme_path [klink.get_html_theme_path()]\n html_theme_options = {\n 'github': 'yourname/yourrepo',\n 'analytics_id': 'UA-your-number-here',\n 'logo': 'logo.png'\n }\n\nKlink also comes with a useful helper function that allows you to integrate an\nIPython Notebook into a .rst file. It basically converts the Notebook to .rst\nand copies the static data (images, etc) to your _static dir. \n\nIf you have IPython Notebooks that you would like to integrate, use the\nfollowing code to your **conf.py**:\n\n.. code:: python\n\n klink.convert_notebooks()\n\nOnce the conversion is done, you will have a .rst file with the same name as\neach one of your notebooks.\n\n\n*NOTE: Place your notebooks in your docs' source dir.*\n\nNow all you have to do is use the **include** command to insert them into your\ndocs.\n\n\nCustomization\n-------------\n\nObviously, some of you will want to customize the theme. The easiest way to\nachieve this is to clone the repo into your _themes folder (create it if it does\nnot exist in your docs' source dir). To change the style, I recommend editing\nthe LESS files themselves. You will also need lessc to convert from less to css.\nSee the css command in the Makefile for an example. \n\nYou may also want to explore the option of using **git subtree**. Here is a good\n`intro tutorial `__.\n\nYou will also need to change your conf.py file. The following settings should\nwork::\n\n html_theme = 'klink'\n html_theme_path ['_themes']\n html_theme_options = {\n 'github': 'yourname/yourrepo',\n 'analytics_id': 'UA-your-number-here',\n 'logo': 'logo.png'\n }\n\n\nLicense\n-------\n\nMIT\n", "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/pmorissette/klink", "keywords": null, "license": "MIT", "maintainer": null, "maintainer_email": null, "name": "klink", "package_url": "https://pypi.org/project/klink/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/klink/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/pmorissette/klink" }, "release_url": "https://pypi.org/project/klink/0.1.9/", "requires_dist": null, "requires_python": null, "summary": "Klink is a simple and clean theme for creating Sphinx docs, inspired by jrnl", "version": "0.1.9" }, "last_serial": 1594938, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "b62867dbf9c88d5ef017ebf9f0a1d0c8", "sha256": "996415333606209610083ee5be74f4162252ab4cf479bdf9924ab58db94614c8" }, "downloads": -1, "filename": "klink-0.1.0.tar.gz", "has_sig": false, "md5_digest": "b62867dbf9c88d5ef017ebf9f0a1d0c8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 27632, "upload_time": "2014-07-01T19:50:33", "url": "https://files.pythonhosted.org/packages/b4/85/c13346ec23293bf7444aac9aee9779fa9d4a092ace5361efd88119b342f3/klink-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "c7a3738fcf3b206e73b0a41ca0a3224c", "sha256": "d7db3b200a380640f6cf94c0deba1982e9cdbc9b90c79eb7641787091312cb89" }, "downloads": -1, "filename": "klink-0.1.1.tar.gz", "has_sig": false, "md5_digest": "c7a3738fcf3b206e73b0a41ca0a3224c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 797738, "upload_time": "2014-07-02T21:08:46", "url": "https://files.pythonhosted.org/packages/54/03/1c5dc7b1a64455465a0373329ca6643fc4b36d97d5ebd1b4905d09022821/klink-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "9ba3f449a608078e5be0e0fc6e61d0f5", "sha256": "cbffd6d57a97459fc1e4c9a00a4e1752fb442ee2beb832b78e1e00bf19d8dab6" }, "downloads": -1, "filename": "klink-0.1.2.tar.gz", "has_sig": false, "md5_digest": "9ba3f449a608078e5be0e0fc6e61d0f5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 797772, "upload_time": "2014-07-03T12:57:24", "url": "https://files.pythonhosted.org/packages/bc/8b/d96544844b3bb5d54606e9706d18ae5b45a903ade16fd7c35230d63d7113/klink-0.1.2.tar.gz" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "5482c63c8e70b63145cbb52ccf193aff", "sha256": "7e255358322ff84de44731367c59a12c82fb2394d6e4a55e320f1689ca2e8cf0" }, "downloads": -1, "filename": "klink-0.1.3.tar.gz", "has_sig": false, "md5_digest": "5482c63c8e70b63145cbb52ccf193aff", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 797803, "upload_time": "2014-07-03T14:10:42", "url": "https://files.pythonhosted.org/packages/fe/43/be0175c736d077f29c025a0728e02d34a6489938e1d7592c5dda8eb5aeb5/klink-0.1.3.tar.gz" } ], "0.1.4": [ { "comment_text": "", "digests": { "md5": "db9c6683e2ecc1de7c49386d7bffa563", "sha256": "1fa27797e61253e9038fc1dae0ba7ce43a3016a90d8de2e697d70d3b72d68387" }, "downloads": -1, "filename": "klink-0.1.4.tar.gz", "has_sig": false, "md5_digest": "db9c6683e2ecc1de7c49386d7bffa563", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 798387, "upload_time": "2014-07-03T20:36:58", "url": "https://files.pythonhosted.org/packages/c8/69/f5d753589393cc33989aed130d5f92049f080bf8d407849375ec00a1b88a/klink-0.1.4.tar.gz" } ], "0.1.5": [ { "comment_text": "", "digests": { "md5": "7a41edabadc18e19f19246d52d58c1b9", "sha256": "cd4916338910bc178c4024589896d766cb1e0752ab4d3569eec5fe8ac70b4131" }, "downloads": -1, "filename": "klink-0.1.5.tar.gz", "has_sig": false, "md5_digest": "7a41edabadc18e19f19246d52d58c1b9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 798387, "upload_time": "2014-07-04T14:59:10", "url": "https://files.pythonhosted.org/packages/7c/44/f9f4a78e2d5cd7f24848144c8bab2d5eb0c8964476b4768a9c895e2c7f89/klink-0.1.5.tar.gz" } ], "0.1.6": [ { "comment_text": "", "digests": { "md5": "41d1a79bd73911117d71366b4720f7be", "sha256": "9224eb12bc042c2aefca5beab058605edcacb4f8a3cfa1b499db1421e16adad2" }, "downloads": -1, "filename": "klink-0.1.6.tar.gz", "has_sig": false, "md5_digest": "41d1a79bd73911117d71366b4720f7be", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 798622, "upload_time": "2014-07-04T19:07:16", "url": "https://files.pythonhosted.org/packages/de/1c/3cbdff406fb26572c6817b90f66c96083ffb58217bb01888ea36df4fe3c0/klink-0.1.6.tar.gz" } ], "0.1.7": [ { "comment_text": "", "digests": { "md5": "1324317d7fd7144a0115405e1ad4a8fa", "sha256": "d3651f4a8174fb38d906b078976b36f148c712c3a039db6ea0f05d2d8b5072da" }, "downloads": -1, "filename": "klink-0.1.7.tar.gz", "has_sig": false, "md5_digest": "1324317d7fd7144a0115405e1ad4a8fa", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 798620, "upload_time": "2014-07-04T19:25:19", "url": "https://files.pythonhosted.org/packages/13/7e/5e3a3c92699d7b1c9e138c2743652c8c9efecdb8074a6808866ca3cca9fe/klink-0.1.7.tar.gz" } ], "0.1.8": [ { "comment_text": "", "digests": { "md5": "8f2c129716a0029533c9aaeab4439ffb", "sha256": "9d30235778071854c2293cc22610b528dbebb92d534c0a2dc47fb47db9d566b0" }, "downloads": -1, "filename": "klink-0.1.8.tar.gz", "has_sig": false, "md5_digest": "8f2c129716a0029533c9aaeab4439ffb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 799628, "upload_time": "2014-07-07T15:17:54", "url": "https://files.pythonhosted.org/packages/f7/ac/9a875380b9e07d233f9fabd08fbec2dafa16fa7521e16a633c62937af741/klink-0.1.8.tar.gz" } ], "0.1.9": [ { "comment_text": "", "digests": { "md5": "d599b13bf66db5f6d4f9b46600cbfa6a", "sha256": "0677cc21f3cfd4fa5a8c1ea61a4ecc4c3475f76023f20dd09757b919aa1e6d6a" }, "downloads": -1, "filename": "klink-0.1.9.tar.gz", "has_sig": false, "md5_digest": "d599b13bf66db5f6d4f9b46600cbfa6a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 801344, "upload_time": "2015-06-16T18:03:50", "url": "https://files.pythonhosted.org/packages/68/10/373d42ed834c4a2159ca93196885c44d97565e62f41e312a401899ff2136/klink-0.1.9.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "d599b13bf66db5f6d4f9b46600cbfa6a", "sha256": "0677cc21f3cfd4fa5a8c1ea61a4ecc4c3475f76023f20dd09757b919aa1e6d6a" }, "downloads": -1, "filename": "klink-0.1.9.tar.gz", "has_sig": false, "md5_digest": "d599b13bf66db5f6d4f9b46600cbfa6a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 801344, "upload_time": "2015-06-16T18:03:50", "url": "https://files.pythonhosted.org/packages/68/10/373d42ed834c4a2159ca93196885c44d97565e62f41e312a401899ff2136/klink-0.1.9.tar.gz" } ] }