diff --git a/README.markdown b/README.markdown index 8738c6f..062f975 100644 --- a/README.markdown +++ b/README.markdown @@ -10,7 +10,7 @@ Features - Readability (CSS optimized for readability, responsive design, compatible with mobile and tablet devices) - Easy setup => **copy and paste the source code and you are done!** - Use a lightweight Sqlite database instead of Mysql or Postgresql -- Remove Feedburner Ads and analytics trackers (1x1 pixels) +- Remove Feedburner Ads and analytic trackers (1x1 pixels) - Open external links inside a new tab with a `rel="noreferrer"` attribute - Use secure HTTP headers (only external images and Youtube/Vimeo/Dailymotion videos are allowed) - Article content is filtered before being displayed diff --git a/docs/config.markdown b/docs/config.markdown index 5863750..1ff8137 100644 --- a/docs/config.markdown +++ b/docs/config.markdown @@ -18,11 +18,17 @@ Actually, the following constants can be overrided: define('HTTP_TIMEOUT', '20'); // HTTP_MAX_RESPONSE_SIZE => Maximum accepted size of the response body in MB (default 2MB) -defined('HTTP_MAX_RESPONSE_SIZE') or define('HTTP_MAX_RESPONSE_SIZE', 2097152); +define('HTTP_MAX_RESPONSE_SIZE', 2097152); // DATA_DIRECTORY => default is data (writable directory) define('DATA_DIRECTORY', __DIR__.'/data'); +// FAVICON_DIRECTORY => default is favicons (writable directory) +define('FAVICON_DIRECTORY', DATA_DIRECTORY.DIRECTORY_SEPARATOR.'favicons'); + +// FAVICON_PUBLIC_DIRECTORY => default is data/favicons/ +define('FAVICON_PUBLIC_DIRECTORY', 'data'.DIRECTORY_SEPARATOR.'favicons'); + // DB_FILENAME => default value is db.sqlite (default database filename) define('DB_FILENAME', 'db.sqlite'); diff --git a/docs/faq.markdown b/docs/faq.markdown index 27e3439..601edac 100644 --- a/docs/faq.markdown +++ b/docs/faq.markdown @@ -43,4 +43,4 @@ I want to send bookmarks to Pinboard. How do I find my Pinboard API token? -------------------------------------------------------------------------- You can find your API token by going to [https://api.pinboard.in/v1/user/api_token/](https://api.pinboard.in/v1/user/api_token/). -Miniflux requires you add your Pinboard username before this, followed by a colon (eg. bobsmith:12FC235692DF53DD1). \ No newline at end of file +Miniflux requires you to add your Pinboard username before this, followed by a colon (eg. bobsmith:12FC235692DF53DD1). \ No newline at end of file diff --git a/docs/multiple-users.markdown b/docs/multiple-users.markdown index 3205b73..f1a4c56 100644 --- a/docs/multiple-users.markdown +++ b/docs/multiple-users.markdown @@ -1,9 +1,9 @@ Multiple users ============== -Since the begining, Miniflux was a single user software. +Since the beginning, Miniflux was a single user software. However, it is now possible to create multiple databases. -Each user have his own Sqlite database and people can choose which database they want to use before the authentication. +Each user has his own Sqlite database and people can choose which database they want to use before the authentication. To create a new database: diff --git a/docs/tests.markdown b/docs/tests.markdown index cc758cd..9ed16eb 100644 --- a/docs/tests.markdown +++ b/docs/tests.markdown @@ -31,7 +31,7 @@ PHPUnit 4.4.0 by Sebastian Bergmann. Install the latest version of Selenium Server --------------------------------------------- -Download the distribution archive of [Selenium Server](http://www.seleniumhq.org/download/) and the platform and browser specific driver. The following browser driver exist: +Download the distribution archive of [Selenium Server](http://www.seleniumhq.org/download/) and the platform and browser specific driver. The following browser driver exists: - Firefox webdriver is default included - [Chrome webdriver](https://sites.google.com/a/chromium.org/chromedriver/downloads) @@ -86,7 +86,7 @@ The following `phpunit.xml` is used to run phpunit on a linux system with apache ``` -Some tests don't run with every browser. You have to exclude those tests by using the ```--exclude-group``` commandline parameter. The following exclude groups exists: +Some tests don't run with every browser. You have to exclude those tests by using the ```--exclude-group``` command line parameter. The following exclude groups exist: * moz_unsupported (Due to https://github.com/SeleniumHQ/selenium/issues/386) * ie_unsupported (Due to https://code.google.com/p/selenium/issues/detail?id=4973) diff --git a/docs/translations.markdown b/docs/translations.markdown index c0aa591..2b30a1f 100644 --- a/docs/translations.markdown +++ b/docs/translations.markdown @@ -5,21 +5,21 @@ How to translate Miniflux to a new language? -------------------------------------------- - Translations are stored inside the directory `locales` -- There is a sub-directory for each language, by example for the French we have `fr_FR`, Italian `it_IT` etc... +- There is a sub-directory for each language, for example in French we have `fr_FR`, Italian `it_IT` etc... - A translation is a PHP file that return an Array with a key-value pairs -- The key is the original text in english and the value is the translation for the corresponding language +- The key is the original text in English and the value is the translation of the corresponding language - **French translations are always up to date** - Always use the last version (branch master) ### Plurals -Each translation file has a plural formula defined. This formula is used to determine wether a plural for the current number is needed. For languages with multiple plurals, the formula determine which plural form is the right one. +Each translation file has a plural formula defined. This formula is used to determine whether a plural for the current number is needed. For languages with multiple plurals, the formula determine which plural form is the right one. You can get the formula for your language from https://localization-guide.readthedocs.org/en/latest/l10n/pluralforms.html. -The formula need to be adjusted to be valid php code. Do not hesitate to ask for an adjusted formula in the bugtracker. +The formula need to be adjusted to be valid php code. Do not hesitate to ask for an adjusted formula in the bug tracker. -You need to create a list of strings for terms that have a plural. For example the plural for the English translation looks like the following: +You need to create a list of strings for terms that have a plural. For example, the plural of the English translation looks like the following: ``` 'plural' => function($n) { return ($n != 1); }, @@ -51,7 +51,7 @@ Translations are displayed with the following functions in the source code: - `tne()`: displayed with no escaping - `dt()`: date using `strftime()` formats -Always use the english version in the source code. +Always use the English version in the source code. How to find missing translations in the applications? ----------------------------------------------------- @@ -62,7 +62,7 @@ From a Unix shell run: ./scripts/find-strings.sh ``` -All missing translations are displayed on the screen. Put that in the french locale and sync other locales (see below). +All missing translations are displayed on the screen. Put that in the French locale and sync other locales (see below). How to synchronize translation files? ------------------------------------- @@ -73,4 +73,4 @@ From a Unix shell run this command: ./scripts/sync-locales.php ``` -The french translation is used a reference for other locales. +The French translation is used a reference to other locales. diff --git a/docs/upgrade.markdown b/docs/upgrade.markdown index 5319df4..036d24a 100644 --- a/docs/upgrade.markdown +++ b/docs/upgrade.markdown @@ -5,15 +5,15 @@ Upgrade to a new version 1. Close your session (logout) 2. Rename your actual miniflux directory (to keep a backup) -3. Uncompress the new archive and copy your database file `db.sqlite` in the directory `data` +3. Decompress the new archive and copy your database file `db.sqlite` in the directory `data` 4. Make the directory `data` writeable by the web server user -5. Login and check if everything is ok +5. Login and check if everything is OK 6. Remove the old miniflux directory ### From the repository (development version) 1. Close your session (logout) 2. `git pull` -3. Login and check if everything is ok +3. Login and check if everything is OK -Note: Always do a backup of your database before! +Note: Always make a backup of your database before!