Name | minchin.pelican.plugins.wikilinks JSON |
Version |
1.0.0
JSON |
| download |
home_page | |
Summary | Support Wikilinks when generating Pelican sites |
upload_time | 2024-01-01 08:07:59 |
maintainer | |
docs_url | None |
author | |
requires_python | |
license | MIT |
keywords |
pelican
plugin
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
=====================
Wikilinks for Pelican
=====================
Support Wikilinks when generating Pelican sites.
``Wikilinks`` is a plugin for `Pelican <http://docs.getpelican.com/>`_,
a static site generator written in Python.
.. image:: https://img.shields.io/pypi/v/minchin.pelican.plugins.wikilinks.svg?style=flat
:target: https://pypi.python.org/pypi/minchin.pelican.plugins.wikilinks
:alt: PyPI version number
.. image:: https://img.shields.io/badge/-Changelog-success?style=flat
:target: https://github.com/MinchinWeb/minchin.pelican.plugins.wikilinks/blob/master/CHANGELOG.rst
:alt: Changelog
.. image:: https://img.shields.io/pypi/pyversions/minchin.pelican.plugins.wikilinks?style=flat
:target: https://pypi.python.org/pypi/minchin.pelican.plugins.wikilinks/
:alt: Supported Python version
.. image:: https://img.shields.io/pypi/l/minchin.pelican.plugins.wikilinks.svg?style=flat&color=green
:target: https://github.com/MinchinWeb/minchin.pelican.plugins.wikilinks/blob/master/LICENSE.txt
:alt: License
.. image:: https://img.shields.io/pypi/dm/minchin.pelican.plugins.wikilinks.svg?style=flat
:target: https://pypi.python.org/pypi/minchin.pelican.plugins.wikilinks/
:alt: Download Count
Installation
============
The easiest way to install ``Wikilinks`` is through the use of pip. This
will also install the required dependencies automatically.
.. code-block:: sh
pip install minchin.pelican.plugins.wikilinks
Further configuration will depend on the version of Pelican you are running. On
version 4.5 or newer and you haven't defined ``PLUGINS`` in your
``pelicanconf.py``, nothing more in needed. On earlier versions of Pelican, or
if you've defined ``PLUGINS``, you'll need to add the autoloader to your list
of plugins in your ``pelicanconf.py`` file:
.. code-block:: python
# pelicanconf.py
PLUGINS = [
# ...
'minchin.pelican.plugins.wikilinks',
# ...
]
Usage Notes
===========
In basic usage, this allow links of the form ``[[ my work ]]`` or
``[[ my work | is finished ]]``. Both of these will create a link to a file
named ``my work`` (e.g. ``my work.md``). By default, the name displayed for the
link will be the filename; alternately add a title to the link by using a bar
and anything after the bar will be used as the displayed name
(e.g. ``| is finished``).
Known Issues
============
The plugin relies on each link target having a unique filename; non-unique
filenames may result in links not going where you were expecting.
Perhaps this should be added as token of a Markdown reader, but the link target
list is only available after all sources have been rendered. Because the plugin
is run after Markdown (or ReStructured) is rendered, there currently isn't a
way to make sure that this isn't run on links within code blocks, etc.
Future To Dos
=============
- support link anchors (e.g. ``my work#heading``)
Raw data
{
"_id": null,
"home_page": "",
"name": "minchin.pelican.plugins.wikilinks",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "William Minchin <w_minchin@hotmail.com>",
"keywords": "pelican,plugin",
"author": "",
"author_email": "William Minchin <w_minchin@hotmail.com>",
"download_url": "https://files.pythonhosted.org/packages/28/60/cb0de5957c0e34a2d5c07b7bcdc252cca4d880ea1284cb907cf0d1dbdc58/minchin.pelican.plugins.wikilinks-1.0.0.tar.gz",
"platform": null,
"description": "=====================\r\nWikilinks for Pelican\r\n=====================\r\n\r\nSupport Wikilinks when generating Pelican sites.\r\n\r\n``Wikilinks`` is a plugin for `Pelican <http://docs.getpelican.com/>`_,\r\na static site generator written in Python.\r\n\r\n.. image:: https://img.shields.io/pypi/v/minchin.pelican.plugins.wikilinks.svg?style=flat\r\n :target: https://pypi.python.org/pypi/minchin.pelican.plugins.wikilinks\r\n :alt: PyPI version number\r\n\r\n.. image:: https://img.shields.io/badge/-Changelog-success?style=flat\r\n :target: https://github.com/MinchinWeb/minchin.pelican.plugins.wikilinks/blob/master/CHANGELOG.rst\r\n :alt: Changelog\r\n\r\n.. image:: https://img.shields.io/pypi/pyversions/minchin.pelican.plugins.wikilinks?style=flat\r\n :target: https://pypi.python.org/pypi/minchin.pelican.plugins.wikilinks/\r\n :alt: Supported Python version\r\n\r\n.. image:: https://img.shields.io/pypi/l/minchin.pelican.plugins.wikilinks.svg?style=flat&color=green\r\n :target: https://github.com/MinchinWeb/minchin.pelican.plugins.wikilinks/blob/master/LICENSE.txt\r\n :alt: License\r\n\r\n.. image:: https://img.shields.io/pypi/dm/minchin.pelican.plugins.wikilinks.svg?style=flat\r\n :target: https://pypi.python.org/pypi/minchin.pelican.plugins.wikilinks/\r\n :alt: Download Count\r\n\r\n\r\nInstallation\r\n============\r\n\r\nThe easiest way to install ``Wikilinks`` is through the use of pip. This\r\nwill also install the required dependencies automatically.\r\n\r\n.. code-block:: sh\r\n\r\n pip install minchin.pelican.plugins.wikilinks\r\n\r\nFurther configuration will depend on the version of Pelican you are running. On\r\nversion 4.5 or newer and you haven't defined ``PLUGINS`` in your\r\n``pelicanconf.py``, nothing more in needed. On earlier versions of Pelican, or\r\nif you've defined ``PLUGINS``, you'll need to add the autoloader to your list\r\nof plugins in your ``pelicanconf.py`` file:\r\n\r\n.. code-block:: python\r\n\r\n # pelicanconf.py\r\n\r\n PLUGINS = [\r\n # ...\r\n 'minchin.pelican.plugins.wikilinks',\r\n # ...\r\n ]\r\n\r\n\r\nUsage Notes\r\n===========\r\n\r\nIn basic usage, this allow links of the form ``[[ my work ]]`` or\r\n``[[ my work | is finished ]]``. Both of these will create a link to a file\r\nnamed ``my work`` (e.g. ``my work.md``). By default, the name displayed for the\r\nlink will be the filename; alternately add a title to the link by using a bar\r\nand anything after the bar will be used as the displayed name \r\n(e.g. ``| is finished``).\r\n\r\nKnown Issues\r\n============\r\n\r\nThe plugin relies on each link target having a unique filename; non-unique\r\nfilenames may result in links not going where you were expecting.\r\n\r\nPerhaps this should be added as token of a Markdown reader, but the link target\r\nlist is only available after all sources have been rendered. Because the plugin\r\nis run after Markdown (or ReStructured) is rendered, there currently isn't a\r\nway to make sure that this isn't run on links within code blocks, etc.\r\n\r\nFuture To Dos\r\n=============\r\n\r\n- support link anchors (e.g. ``my work#heading``)\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Support Wikilinks when generating Pelican sites",
"version": "1.0.0",
"project_urls": {
"Bug Tracker": "https://github.com/MinchinWeb/minchin.pelican.plugins.wikilinks/issues",
"Repository": "https://github.com/MinchinWeb/minchin.pelican.plugins.wikilinks"
},
"split_keywords": [
"pelican",
"plugin"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "491741fd9cc01f53228b20cee8807f89820a0faa5a552de0041a3100d6f048d3",
"md5": "6a3e352b888482e55dc0eb442c3bed85",
"sha256": "419b27844e54979529403fc56893415ba3eaf0b8f146e61352cd95c8d6fd0473"
},
"downloads": -1,
"filename": "minchin.pelican.plugins.wikilinks-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6a3e352b888482e55dc0eb442c3bed85",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 6709,
"upload_time": "2024-01-01T08:09:01",
"upload_time_iso_8601": "2024-01-01T08:09:01.788995Z",
"url": "https://files.pythonhosted.org/packages/49/17/41fd9cc01f53228b20cee8807f89820a0faa5a552de0041a3100d6f048d3/minchin.pelican.plugins.wikilinks-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2860cb0de5957c0e34a2d5c07b7bcdc252cca4d880ea1284cb907cf0d1dbdc58",
"md5": "402767eed8dd784fd6fd36eac4d3c881",
"sha256": "2b37a813cfffb393189f515ef4ec52dd4ccfcd8ca0c33248860fdf8f6bbe43fd"
},
"downloads": -1,
"filename": "minchin.pelican.plugins.wikilinks-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "402767eed8dd784fd6fd36eac4d3c881",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6507,
"upload_time": "2024-01-01T08:07:59",
"upload_time_iso_8601": "2024-01-01T08:07:59.597466Z",
"url": "https://files.pythonhosted.org/packages/28/60/cb0de5957c0e34a2d5c07b7bcdc252cca4d880ea1284cb907cf0d1dbdc58/minchin.pelican.plugins.wikilinks-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-01 08:07:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MinchinWeb",
"github_project": "minchin.pelican.plugins.wikilinks",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "minchin.pelican.plugins.wikilinks"
}