pelican-gemini-capsule 0.4.0

Pelican plugin to generate Gemini capsules

Pelican Gemini Capsule is a Pelican plugin to generate Gemini capsules. Only works with articles in reStructuredText formats.

This project is currently work in progress.

Requirements

• Python >= 3.9

• rst2gemtext

Installation

pip install pelican-gemini-capsule

Usage

Once Pelican Gemini Capsule installed, simply add it to you Pelican configuration:

PLUGINS = [
    "pelican_gemini_capsule",
]

Configuration

You can configure this plugin by adding the following variables to your pelicanconf.py:

# How many articles to display on the home page
GEMINI_DISPLAYED_ARTICLE_COUNT_ON_HOME = 10

# Template of the home page of the Gemlog
GEMINI_TEMPLATE_HOME = """\
# {{ SITENAME }}

## Latest Articles
{% for i in range(articles_count_on_home) %}{% set article = articles[i] %}
=> {{ GEMSITEURL }}/{{ article.url | replace(".html", ".gmi") }} {{ article.date.strftime("%Y-%m-%d") }} {{ article.raw_title -}}
{% endfor %}
{% if articles | length > articles_count_on_home %}
=> {{ GEMSITEURL }}/all_articles.gmi ➕ All Articles
{% endif %}
"""

# Template of the "All Articles" page
GEMINI_TEMPLATE_ARTICLES_INDEX_PAGE = """\
# All Articles — {{ SITENAME }}
{% for article in articles %}
=> {{ GEMSITEURL }}/{{ article.url | replace(".html", ".gmi") }} {{ article.date.strftime("%Y-%m-%d") }} {{ article.raw_title -}}
{% endfor %}

--------------------------------------------------------------------------------
=> {{ GEMSITEURL }}/ 🏠 Home
"""

# Template of articles
GEMINI_TEMPLATE_ARTICLE = """\
# {{ article.raw_title }}
{{ article.date.strftime("%Y-%m-%d") }}

{{ article.content_gemtext }}

--------------------------------------------------------------------------------
=> {{ GEMSITEURL }}/ 🏠 Home
"""

Contributing

Questions

If you have any question, you can:

• Open an issue on GitHub

• Ask on Discord (I am not always available to chat, but I try to answer to everyone)

Bugs

Please open an issue on GitHub with as much information as possible if you found a bug:

• Your operating system / Linux distribution (and its version)

• How you installed the software

• All the logs and message outputted by the software

• etc.

If the issue is about the outputted Gemtext (wrong markup, unsupported reStructuredText feature,…), please report the bug to the rst2gemtext project.

Pull requests

Please consider filing a bug before starting to work on a new feature; it will allow us to discuss the best way to do it. It is obviously unnecessary if you just want to fix a typo or small errors in the code.

Please note that your code must follow the coding style defined by the pep8 and pass tests. Black and Flake8 are used on this project to enforce the coding style.

Check codding style

You must install Nox first:

pip3 install nox

Then you can check for lint error:

nox --session lint

You can also fix coding style errors automatically with:

nox -s black_fix

Support this project

Want to support this project?

• ☕️ Buy me a coffee

• 💵️ Give me a tip on PayPal

• ❤️ Sponsor me on GitHub

Changelog

• [NEXT] (changes on master, but not released yet):

  • Nothing yet ;)

• v0.4.0:

  • fix: Deduplicates identical links that follow each other in the document (@flozz)

  • misc(packaging): Modernized packaging: replaced setup.py and setuptools by pyproject.toml and flit (@flozz)

  • misc: Added Python 3.12, 3.13 support (@flozz)

  • misc!: Removed Python 3.7, 3.8 support (@flozz)

• v0.3.1:

  • fix: Fixed missing code blocks in outputed Gemtext (@flozz)

• v0.3.0:

  • feat: Resolve internal links ({filename}../foo/bar.rst) (@flozz)

• v0.2.0:

  • feat: Pass the articles source file name to docutils to allow the include directive to work (@flozz)

  • feat: Added a raw_title attibute on article with decoded HTML entities (@flozz)

  • fix: Create the output folder before trying to write articles (@flozz)

  • fix: Avoid having the same image linked twice in articles (@flozz)

• v0.1.0:

  • Initial release.

  • Generates home page

  • Generates articles index page

  • Generates articles

  • Configurable templates