update docs

This commit is contained in:
Martin Rotter 2021-02-03 10:52:08 +01:00
parent d8815e00c7
commit e7d5e0c377
2 changed files with 226 additions and 30 deletions

View File

@ -1062,6 +1062,13 @@ or this functionality is not implemented yet.</translation>
<translation type="unfinished"></translation>
</message>
</context>
<context>
<name>FormEditGreaderAccount</name>
<message>
<source>Server setup</source>
<translation type="unfinished"></translation>
</message>
</context>
<context>
<name>FormEditInoreaderAccount</name>
<message>
@ -2434,6 +2441,128 @@ Login tokens expiration: %2</source>
<translation type="unfinished"></translation>
</message>
</context>
<context>
<name>GreaderAccountDetails</name>
<message>
<source>Service</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>URL</source>
<translation type="unfinished">URL </translation>
</message>
<message>
<source>Only download newest X messages per feed</source>
<translation type="unfinished"></translation>
</message>
<message>
<source> = unlimited</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Some feeds require authentication, including GMail feeds. BASIC, NTLM-2 and DIGEST-MD5 authentication schemes are supported.</source>
<translation type="unfinished">Some feeds require authentication, including GMail feeds. BASIC, NTLM-2 and DIGEST-MD5 authentication schemes are supported. </translation>
</message>
<message>
<source>Authentication</source>
<translation type="unfinished">Authentication</translation>
</message>
<message>
<source>Username</source>
<translation type="unfinished">Username </translation>
</message>
<message>
<source>Password</source>
<translation type="unfinished">Password </translation>
</message>
<message>
<source>Show password</source>
<translation type="unfinished">Show password </translation>
</message>
<message>
<source>&amp;Test setup</source>
<translation type="unfinished">&amp;Test setup </translation>
</message>
<message>
<source>Password for your account</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Username for your account</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>URL of your server, without any service-specific path</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>No test done yet.</source>
<translation type="unfinished">No test done yet.</translation>
</message>
<message>
<source>Here, results of connection test are shown.</source>
<translation type="unfinished">Here, results of connection test are shown.</translation>
</message>
<message>
<source>Limiting number of downloaded messages per feed makes updating of feeds faster, but if your feed contains bigger number of messages than specified limit, then some older messages might not be downloaded during feed update.</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>= unlimited</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>messages</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Network error: &apos;%1&apos;.</source>
<translation type="unfinished">Network error: &apos;%1&apos;.</translation>
</message>
<message>
<source>Network error, have you entered correct Nextcloud endpoint and password?</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>You are good to go!</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Yeah.</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Username cannot be empty.</source>
<translation type="unfinished">Username cannot be empty.</translation>
</message>
<message>
<source>Username is okay.</source>
<translation type="unfinished">Username is okay.</translation>
</message>
<message>
<source>Password cannot be empty.</source>
<translation type="unfinished">Password cannot be empty.</translation>
</message>
<message>
<source>Password is okay.</source>
<translation type="unfinished">Password is okay.</translation>
</message>
<message>
<source>URL cannot be empty.</source>
<translation type="unfinished">URL cannot be empty.</translation>
</message>
<message>
<source>URL is okay.</source>
<translation type="unfinished">URL is okay.</translation>
</message>
</context>
<context>
<name>GreaderNetwork</name>
<message>
<source>Unknown service</source>
<translation type="unfinished"></translation>
</message>
</context>
<context>
<name>IOFactory</name>
<message>
@ -3140,11 +3269,11 @@ Login tokens expiration: %2</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Failed to starting OAuth redirection listener. Maybe your rights are not high enough.</source>
<source>You can close this window now. Go back to %1.</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>You can close this window now. Go back to %1.</source>
<source>Failed to start OAuth redirection listener. Maybe your rights are not high enough.</source>
<translation type="unfinished"></translation>
</message>
</context>
@ -3363,6 +3492,10 @@ version by clicking this popup notification.</source>
<source>Standard online feeds (RSS/ATOM/JSON)</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Google Reader API is used by many online RSS readers. This is here to support</source>
<translation type="unfinished"></translation>
</message>
</context>
<context>
<name>RecycleBin</name>
@ -3401,6 +3534,29 @@ version by clicking this popup notification.</source>
</translation>
</message>
</context>
<context>
<name>ScriptException</name>
<message>
<source>script line is not well-formed</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>script threw an error</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>script&apos;s interpreter was not found</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>script execution took too long</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>unknown error</source>
<translation type="unfinished">unknown error</translation>
</message>
</context>
<context>
<name>SearchTextWidget</name>
<message>
@ -3859,6 +4015,10 @@ Authors of this application are NOT responsible for lost data.</translation>
<source>Bring application window to front once message is opened in external web browser</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Display real icons of feeds in list of messages instead of read/unread icons</source>
<translation type="unfinished"></translation>
</message>
</context>
<context>
<name>SettingsGeneral</name>
@ -4085,10 +4245,6 @@ Authors of this application are NOT responsible for lost data.</translation>
<source>Metadata not fetched</source>
<translation>Metadata not fetched</translation>
</message>
<message>
<source>Metadata was not fetched because: %1.</source>
<translation>Metadata was not fetched because: %1.</translation>
</message>
<message>
<source>
Network status: %1
@ -4096,6 +4252,22 @@ Encoding: %2
Type: %3</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Script</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Local file</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Unknown</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Metadata was not fetched.</source>
<translation type="unfinished"></translation>
</message>
</context>
<context>
<name>StandardFeedDetails</name>
@ -4135,10 +4307,6 @@ Type: %3</source>
<source>Description</source>
<translation type="unfinished">Description</translation>
</message>
<message>
<source>URL</source>
<translation type="unfinished">URL </translation>
</message>
<message>
<source>Fetch metadata</source>
<translation type="unfinished">Fetch metadata</translation>
@ -4171,14 +4339,6 @@ Type: %3</source>
<source>Set description for your feed.</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Full feed url including scheme</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Set url for your feed.</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Icon selection</source>
<translation type="unfinished">Icon selection</translation>
@ -4207,18 +4367,10 @@ Type: %3</source>
<source>Icon metadata fetched.</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Result: %1.</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Icon metadata not fetched.</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Error: %1.</source>
<translation type="unfinished">Error: %1.</translation>
</message>
<message>
<source>No icon fetched.</source>
<translation type="unfinished"></translation>
@ -4296,6 +4448,50 @@ Type: %3</source>
<source>Icon type:</source>
<translation type="unfinished">Icon type:</translation>
</message>
<message>
<source>Source</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Post-process script</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>You can use URL as a source of your feed or you can produce your feed with custom script. Also, you can post-process generated feed data with yet another script if you wish. These are advanced features and make sure to read the documentation before your use them.</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Full feed source identifier</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Full feed source identifier which can be URL.</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Full command to execute</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>You can enter full command including interpreter here.</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>Here you can enter script executaion line, including interpreter.</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>The source is ok.</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>The source needs to include &quot;#&quot; separator.</source>
<translation type="unfinished"></translation>
</message>
<message>
<source>The source is empty.</source>
<translation type="unfinished"></translation>
</message>
</context>
<context>
<name>StandardServiceRoot</name>

View File

@ -46,15 +46,15 @@ You just select output file (in case of OPML export), check desired feeds and hi
### Websites scraping and related advanced features
> **Only proceed if you consider yourself as power user and you know you are doing!**
> **Only proceed if you consider yourself to be a power user and you know what you are doing!**
RSS Guard 3.9.0+ offers extra advanced features which are inspired by [Liferea](https://lzone.de/liferea/).
You can select source type of each feed. If you select `URL`, then RSS Guard simply downloads feed file from given location.
You can select source type of each feed. If you select `URL`, then RSS Guard simply downloads feed file from given location and behave like everyone would expect.
However, if you choose `Script` option, then you cannot provide URL of your feed and you rely on custom script to obtain your script and provide its contents to **standard output**. Resulting data written to standard output should be valid feed file, for example RSS or ATOM XML file.
However, if you choose `Script` option, then you cannot provide URL of your feed and you rely on custom script to generate feed file and provide its contents to **standard output**. Resulting data written to standard output should be valid feed file, for example RSS or ATOM XML file.
`Fetch ut now` button also works with `Script` option. Therefore, if your source script and (optional) post-process script in cooperation deliver a valid feed file to the output, then all important metadata, like title or icon of the feed, can be automagically discovered.
`Fetch it now` button also works with `Script` option. Therefore, if your source script and (optional) post-process script in cooperation deliver a valid feed file to the output, then all important metadata, like title or icon of the feed, can be automagically discovered.
<img src="images/scrape-source-type.png" width="50%">