Static site generator that supports Markdown and reST syntax. Powered by Python.
Find a file
Justin Mayer 5338f4fac2
Merge pull request #3447 from ceyusa/update-docs
docs: Update install from sources using setuptools
2025-03-25 09:51:00 -07:00
.github Drop support for EOL Python 3.8 2024-12-21 15:53:13 +02:00
docs docs: Update install from sources using setuptools 2025-01-27 06:18:55 +01:00
pelican fix: Fix auto-reload with globs in IGNORE_FILES (#3441) 2025-01-15 17:40:27 +01:00
requirements Bump Pygments to 2.16.1 in test requirements; fixes #3385 (#3386) 2024-09-12 14:21:12 +02:00
samples pre-commit filter auto-indents templates, css, js 2024-05-31 07:34:01 -05:00
.coveragerc Improve test coverage, docs, and .gitignore 2024-06-01 18:51:46 -05:00
.editorconfig Adjust line length to 88 in EditorConfig 2023-10-31 16:50:48 +01:00
.git-blame-ignore-revs Ignore Ruff UP031 fixes in git blame 2024-06-02 09:01:21 +02:00
.gitattributes Tell GitHub-Linguist to ignore HTML files 2023-08-27 16:47:45 +02:00
.gitignore Adjust list of Git-ignored files 2024-09-16 15:11:14 +02:00
.mailmap .mailmap: Add mappings to consolidate author names and emails 2013-04-12 10:51:48 -04:00
.pre-commit-config.yaml pre-commit autoupdate and fix new issues pointed out by ruff 2024-11-03 13:32:32 -06:00
.readthedocs.yaml Build docs in zipped HTML and PDF formats 2023-08-03 14:44:13 +02:00
.vale.ini Add initial configuration for Vale prose linter 2024-07-30 09:56:27 +02:00
CONTRIBUTING.rst Rename default branch to main 2024-06-25 11:33:28 +02:00
LICENSE Update links to HTTPS and current 301 redirects in docs/templates/themes (#2661) 2020-04-12 16:38:35 +02:00
pyproject.toml Release Pelican 4.11.0 2025-01-15 17:01:09 +00:00
README.rst Rename default branch to main 2024-06-25 11:33:28 +02:00
tasks.py Enforce 75% code coverage in CI via Tox 2024-06-25 10:54:24 +02:00
THANKS Add more contributors to THANKS 2021-10-12 15:58:53 +02:00
tox.ini Drop support for EOL Python 3.8 2024-12-21 15:53:13 +02:00

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Pelican |build-status| |pypi-version| |downloads| |repology|
============================================================

Pelican is a static site generator, written in Python_, that allows you to create
web sites by composing text files in formats such as Markdown, reStructuredText, and HTML.

With Pelican, you can create web sites without worrying about databases or server-side programming.
Pelican generates static sites that can be served via any web server or hosting service.

You can perform the following functions with Pelican:

* Compose content in Markdown_ or reStructuredText_ using your editor of choice
* Simple command-line tool (re)generates HTML, CSS, and JS from your source content
* Easy to interface with version control systems and web hooks
* Completely static output is simple to host anywhere


Features
--------

Pelicans feature highlights include:

* Chronological content (e.g., articles, blog posts) as well as static pages
* Integration with external services
* Site themes (created using Jinja2_ templates)
* Publication of articles in multiple languages
* Generation of Atom and RSS feeds
* Code syntax highlighting via Pygments_
* Import existing content from WordPress, Dotclear, or RSS feeds
* Fast rebuild times due to content caching and selective output writing
* Extensible via a rich plugin ecosystem: `Pelican Plugins`_

Check out the `Pelican documentation`_ for further information.


How to get help, contribute, or provide feedback
------------------------------------------------

See our `contribution submission and feedback guidelines <CONTRIBUTING.rst>`_.


Source code
-----------

Pelicans source code is `hosted on GitHub`_. For information on how it works,
have a look at `Pelican's internals`_.


Why the name “Pelican”?
-----------------------

“Pelican” is an anagram of *calepin*, which means “notebook” in French.


.. Links

.. _Python: https://www.python.org/
.. _reStructuredText: http://docutils.sourceforge.net/rst.html
.. _Markdown: https://daringfireball.net/projects/markdown/
.. _Jinja2: https://palletsprojects.com/p/jinja/
.. _Pygments: https://pygments.org/
.. _`Pelican Plugins`: https://github.com/pelican-plugins
.. _`Pelican documentation`: https://docs.getpelican.com/
.. _`Pelican's internals`: https://docs.getpelican.com/en/latest/internals.html
.. _`hosted on GitHub`: https://github.com/getpelican/pelican

.. |build-status| image:: https://img.shields.io/github/actions/workflow/status/getpelican/pelican/main.yml?branch=main
   :target: https://github.com/getpelican/pelican/actions/workflows/main.yml?query=branch%3Amain
   :alt: GitHub Actions CI: continuous integration status
.. |pypi-version| image:: https://img.shields.io/pypi/v/pelican.svg
   :target: https://pypi.org/project/pelican/
   :alt: PyPI: the Python Package Index
.. |downloads| image:: https://img.shields.io/pypi/dm/pelican.svg
   :target: https://pypi.org/project/pelican/
   :alt: Monthly Downloads from PyPI
.. |repology| image:: https://repology.org/badge/tiny-repos/pelican.svg
   :target: https://repology.org/project/pelican/versions
   :alt: Repology: the packaging hub