Preprocessor for Foliant for generating history of releases.
Project description
History
History is a preprocessor that generates single linear history of releases for multiple Git repositories based on their changelogs. The history may be represented as Markdown, and as RSS feed.
Installation
$ pip install foliantcontrib.history
Config
To enable the preprocessor, add history
to preprocessors
section in the project config:
preprocessors:
- history
The preprocessor has a number of options with the following default values:
- history:
repos: []
revision: master
changelog: changelog.md
title: History of Releases
source_heading_level: 1
target_top_level: 1
date_format: year_first
link: false
limit: 0
rss: false
rss_file: rss.xml
rss_title: History of Releases
rss_link: ''
rss_description: ''
rss_language: en-US
repos
: List of URLs of Git repositories that it’s necessary to generate history for.
Example:
```yaml
repos:
- https://github.com/foliant-docs/foliant.git
- https://github.com/foliant-docs/foliantcontrib.includes.git
```
revision
: Revision or branch name to use. Branches that are used for stable releases must have the same names in all listed repositories.
changelog
: Path to changelog file. Changelogs must be located at the same paths in all listed repositories.
title
: Content of the top-level heading of the target Markdown content of generated history.
source_heading_level
: Level of headings that precede descriptions of releases in the source Markdown content. It must be the same for all listed repositories.
target_top_level
: Level of the heading that contains the title
value in the target Markdown content of generated history.
date_format
: Output date format to use in the target Markdown content. If the default value year_first
is used, the date “September 4, 2019” will be represented as 2019-09-04
. If the day_first
value is used, this date will be represented as 04.09.2019
.
link
: Flag that tells the preprocessor to add the link to the repository to each heading of history item in the target Markdown content.
limit
: Maximum number of items to include into the target Markdown content; 0
means no limit.
rss
: Flag that tells the preprocessor to export the history into RSS feed. Note that the parameters title
, target_top_level
, date_format
, link
, and limit
are applied to Markdown content only, not to RSS feed content.
rss_file
: Subpath to the file with RSS feed. It’s relative to the temporary working directory during building, to the directory of built project after building, and to the rss_link
value in URLs.
rss_title
: RSS channel title.
rss_link
: RSS channel link, e.g. https://foliant-docs.github.io/docs/
. If the rss
parameter value is rss.xml
, the RSS feed URL will be https://foliant-docs.github.io/docs/rss.xml
.
rss_description
: RSS channel description.
rss_language
: RSS channel language.
Usage
To insert some history into Markdown content, use the <<history></history>
tags:
Some optional content here.
<<history></history>
More optional content.
If no attributes specified, the values of options from the project config will be used.
You may override each config option value with the attribute of the same name. Example:
<<history
repos="https://github.com/foliant-docs/foliantcontrib.mkdocs.git"
revision="develop"
link="true"
limit="5"
rss="true"
rss_file="some_another.xml"
...
>
</history>
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for foliantcontrib.history-1.0.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | a6ddb3550296cd41ad6178d2bdda9b65d15a6dc81c227516a1223009b47c14de |
|
MD5 | 39d13564c605690828af1777143fe3c9 |
|
BLAKE2b-256 | 8608983d9887f60595df258ab34b1c01c11aa797200c345a515af5539fbb3b0c |
Hashes for foliantcontrib.history-1.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 731ae69cd333641b923e2b6bbf4c1840799cd1bfe459acf3261fe4632b65a231 |
|
MD5 | 707439f5e1f58960a057c57b9af5612e |
|
BLAKE2b-256 | 696baf6318946e9ccd4fb096cb4cc7efdf0e51c15b9a1b5210e1bad3ac270089 |