This plugin enables plugin authors to write their plugin readme content inside a page (or set of pages) or post on their site and then at the click of a button generate the associated valid readme.txt file automatically.
Some improvements that I hope to make to the plugin:
The plugin has a number of options some are saved locally with individual posts/pages and some are global and are used to modify the behaviour of the plugin.
Sets the name of the Plugin for which the readme.txt file is to be generated. This options is saved for each plugin page/post.
This sets the list of contributors for the plugin. This option is saved for each plugin page/post, and the default for this value can be set in the global options.
This sets the donate link for the plugin. This option is saved for each plugin page/post, and the default for this value can be set in the global options.
This sets the list of tags for the plugin. This option is saved for each plugin page/post, and the default for this value can be set in the global options.
This sets the minimum required version of WordPress that the plugin will work with. This option is saved for each plugin page/post, and the default for this value can be set in the global options.
This sets the highest version of WordPress that the plugin has been tested against. This option is saved for each plugin page/post, and the default for this value can be set in the global options.
This sets the stable version of the plugin that should be downloaded by users. This option is saved for each plugin page/post.
The plugin subdirectory where the ‘readme.txt’ should be written, usually set to the plugin directory. This is relative to the WordPress plugin directory ‘wp-content/plugins’.
If there are any sections or sub-sections that are in the post that should not be present in the readme.txt, then enter their names here as a comma separated list.
This global setting, defines what html element the plugin will use to define the plugin top level headings & sections.
This global setting, defines what html element the plugin will use to define the plugin sub-headings & sections.
If all your plugin posts are of a specific category, then put the category’s slug or ID’s in this setting so that the Readme Generator is enabled by default for these posts.
If all your plugin posts are children of a specific post/page, then put the post’s slug or ID’s in this setting so that the Readme Generator is enabled by default for these posts.
The name of the file that the Readme Generator will create, by default this is ‘readme.txt’, if you want to keep your existing readme.txt set this to something else.
If this option is selected then it will also append any pages that are children of the current page to the readme.txt file.
The plugin can generate a .pot file, however this is quiet primitive, enable this option to generate the POT file. This option is saved for each plugin page/post, and the default for this value can be set in the global options.
The name of the .pot file that the Readme Generator will create, by default this is ‘i18n/%SLUG%.pot’. The location is relative to the directory of the ‘readme.txt’, and the phrase %SLUG% will be replaced with the Plugin Name (e.g. plugin-name).
The plugin comes with translation support but as yet no translations are included. Please refer to the WordPress Codex for more information about activating the translation. If you want to help to translate the plugin to your language, please have a look at the i18n/readme-gen.pot file which contains all definitions and may be used to create a language specific .po file. If you do create a translation please contact me and I will add it to the plugin ready for the next update.