From 4ed27c721f1ac611828b7d51e645db26fc1cb9f9 Mon Sep 17 00:00:00 2001 From: Carl Chenet Date: Tue, 31 Dec 2019 12:26:43 +0100 Subject: [PATCH] add explainations for no_tags_in_toot, toot_max_len and line break in toot --- docs/source/configure.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/source/configure.rst b/docs/source/configure.rst index a6f1170..e18a5eb 100644 --- a/docs/source/configure.rst +++ b/docs/source/configure.rst @@ -41,6 +41,7 @@ In order to configure Feed2toot, you need to create a feed2toot.ini file (or any uri=https://www.journalduhacker.net/rss uri_list=/etc/feed2toot//rsslist.txt toot={title} {link} + ; toot_max_len=125 title_pattern=Open Source title_pattern_case_sensitive=true no_uri_pattern_no_global_pattern=true @@ -48,6 +49,7 @@ In order to configure Feed2toot, you need to create a feed2toot.ini file (or any [hashtaglist] several_words_hashtags_list=/etc/feed2toot/hashtags.txt + ; no_tags_in_toot=false [feedparser] accept_bozo_exceptions=true @@ -81,7 +83,8 @@ For the [rss] section: - uri: the url of the rss feed to parse - uri_list: a path to a file with several adresses of rss feeds, one by line. Absolute path is mandatory. -- toot: format of the toot you want to post. It should use existing entries of the RSS fields like {title} or {link}. Launch it with this field empty to display all available entries. If you want to shorten the size of a field, you can use the syntax {summary:.100} to cut the field "summary" of the rss feed after the first 100 characters (starting from Feed2toot 0.10). +- toot: format of the toot you want to post. It should use existing entries of the RSS fields like {title} or {link}. Launch it with this field empty to display all available entries. If you want to shorten the size of a field, you can use the syntax {summary:.100} to cut the field "summary" of the rss feed after the first 100 characters (starting from version 0.10). To add new lines you can use \n (starting from version 0.14) +- toot_max_len: the max length of a toot can be defined here. If the toot size is longer, the toot is truncated and "..." added at the end. Defaults is 500 characters. - {one field of the rss feed}_pattern: takes a string representing a pattern to match for a specified field of each rss entry of the rss feed, like title_pattern or summary_pattern. - {one field of the rss feed}_pattern_case_sensitive: either the pattern matching for the specified field should be case sensitive or not. Default to true if not specified. - no_uri_pattern_no_global_pattern: don't apply global pattern (see above) when no pattern-by-uri is defined in the uri_list. Allows to get all entries of a rss in the uri_list because no pattern is defined so we match them all. Defaults to false, meaning the global patterns will be tried on every rss in the uri_list NOT HAVING specific patterns and so ONLY entries from the specific uri in the uri_list matching the global patterns will be considered. @@ -91,6 +94,7 @@ For the [rss] section: For the [hashtaglist] section: - several_words_hashtags_list: a path to the file containing hashtags in two or more words. Absolute path is mandatory. By default Feed2toot adds a # before every words of a hashtag. See documentation below for an example of this file. +- no_tags_in_toot: stop hash tags to be added at the toot. Defaults to false. for the [feedparser] section: