/pronamic-changelog-md-to-wordpress-plugin-readme-txt

Automates syncing of changelog entries from CHANGELOG.md to WordPress plugin readme.txt.

Primary LanguagePHPGNU General Public License v2.0GPL-2.0

Pronamic CHANGELOG.md to WordPress plugin readme.txt

Automates syncing of changelog entries from CHANGELOG.md to WordPress plugin readme.txt.

Table of contents

Usage

To keep this library simple, two markers are needed in CHANGELOG.md and readme.txt.

<!-- Start changelog -->
<!-- End changelog -->

WordPress plugin readme.txt

https://wordpress.org/plugins/readme.txt

=== Plugin Name ===
Contributors: (this should be a list of wordpress.org userid's)
Donate link: https://example.com/
Tags: tag1, tag2
Requires at least: 4.7
Tested up to: 5.4
Stable tag: 4.3
Requires PHP: 7.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Here is a short description of the plugin.  This should be no more than 150 characters.  No markup here.

== Description ==

This is the long description.  No limit, and you can use Markdown (as well as in the following sections).

== Changelog ==

⬇️
<!-- Start changelog -->

ℹ️ This is where the content from CHANGELOG.md is inserted.

<!-- End changelog -->
⬆️

If you don't want to include the complete CHANGELOG.md in your readme.txt you can move the <!-- End changelog --> marker to the desired position. Additionally you can include a text below the <!-- End changelog --> marker in the readme.txt file, for example:

[See changelog for all versions.](https://github.com/…/blob/main/CHANGELOG.md)

Composer script

	"scripts": {
		"changelog": "Pronamic\\ChangelogMdToWordPressPluginReadmeTxt\\Synchronizer::run"
	}
	"scripts": {
		"changelog": "vendor/bin/pronamic-changelog-md-to-wordpress-plugin-readme-txt"
	}

Exit code

Exit code Description
0 Succes.
1 Error.

Links