=====================
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``)
Prior Art
=========
This plugin relies on much work that has gone before, both explicitly for code
and implicitely for the encouragement of this even being possible. This list is
sadly incomplete, but in particlar:
- Johnathan Sundqvist's `Obisidian Plugin for Pelican
<https://github.com/jonathan-s/pelican-obsidian>`_ (and forks) -- in
particular, for providing inspiration on how to deal with Wiki-style links
Raw data
{
"_id": null,
"home_page": null,
"name": "minchin.pelican.plugins.wikilinks",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": "William Minchin <w_minchin@hotmail.com>",
"keywords": "pelican, plugin",
"author": null,
"author_email": "William Minchin <w_minchin@hotmail.com>",
"download_url": "https://files.pythonhosted.org/packages/b6/c2/b44a347e9a3691ba8634a794584f087de9776673303a953e4e8dffd95bf4/minchin_pelican_plugins_wikilinks-1.0.1.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\r\nPrior Art\r\n=========\r\n\r\nThis plugin relies on much work that has gone before, both explicitly for code\r\nand implicitely for the encouragement of this even being possible. This list is\r\nsadly incomplete, but in particlar:\r\n\r\n- Johnathan Sundqvist's `Obisidian Plugin for Pelican\r\n <https://github.com/jonathan-s/pelican-obsidian>`_ (and forks) -- in\r\n particular, for providing inspiration on how to deal with Wiki-style links\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Support Wikilinks when generating Pelican sites",
"version": "1.0.1",
"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": null,
"digests": {
"blake2b_256": "5ad134c67ceeb88f724a021d5678d5053c80f4706936b6f1626e7f53629502eb",
"md5": "fc0e6391954de739e27f1a745c554258",
"sha256": "fa31afefe7bd4acc13695d1664f57ed08c4f8ab7e990cbdf0f067b87481cfcb6"
},
"downloads": -1,
"filename": "minchin_pelican_plugins_wikilinks-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fc0e6391954de739e27f1a745c554258",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 6975,
"upload_time": "2025-08-25T00:10:32",
"upload_time_iso_8601": "2025-08-25T00:10:32.535425Z",
"url": "https://files.pythonhosted.org/packages/5a/d1/34c67ceeb88f724a021d5678d5053c80f4706936b6f1626e7f53629502eb/minchin_pelican_plugins_wikilinks-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b6c2b44a347e9a3691ba8634a794584f087de9776673303a953e4e8dffd95bf4",
"md5": "f213567e65db390516488cef15aaa0f7",
"sha256": "7f71749462971e24b0047d0981ff441b6e53fa8fd606c2ed36829608dae25bd3"
},
"downloads": -1,
"filename": "minchin_pelican_plugins_wikilinks-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "f213567e65db390516488cef15aaa0f7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7202,
"upload_time": "2025-08-25T00:08:04",
"upload_time_iso_8601": "2025-08-25T00:08:04.442036Z",
"url": "https://files.pythonhosted.org/packages/b6/c2/b44a347e9a3691ba8634a794584f087de9776673303a953e4e8dffd95bf4/minchin_pelican_plugins_wikilinks-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-25 00:08:04",
"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"
}
JSON
