This project is a part of wallabag. It contains all the user and technical documentation of wallabag.
-
Structure
-
Each translation is contained in a folder, with sub-folders. For example, for english translation, we have:
-
- en
-| 01_User_documentation
---| a file per feature
---| ...
-| 02_Technical_documentation
---| a file per feature
---| ...
-| 00_Getting_started.md: a presentation of wallabag
-| 01_Help_wallabag.md: how you can contribute to the project
-
If you want to translate the documentation in your language, please respect this structure.
Welcome on wallabag documentation. Thanks to this tool, we hope that you can easily use wallabag and work with it.
+
Today, we have two documentations: for users and for developers. Just select your language and good reading!
+Feel free to contribute to this documentation. It's your documentation.
Wenn du wallabag nicht auf einem eigenen Server installieren kannst oder möchtest, solltest du ein kostenloses Benutzerkonto auf Framabag erstellen, wo wallabag genutzt wird.
Um zu überprüfen, ob dein Server die Voraussetzungen erfüllt, kannst du wallabag_compatibility_test.php ausführen. Diese Datei liegt im install-Verzeichnis von wallabag.
+
Installation der Abhängigkeiten
+
Damit wallabag ordnungsgemäß funktioniert, müssen einige Abhängigkeiten erfüllt werden. Um diese zu installieren, muss composer verwendet werden. Führe folgende Kommandos in deinem wallabag-Verzeichnis aus:
Falls du composer nicht installieren kannst, kannst du alternativ vendor.zip herunterladen und in deinem wallabag-Verzeichnis entpacken.
+
Berechtigungen
+
Dein Webserver braucht Schreibrechte in den Verzeichnissen assets, cache, und db. Bei fehlenden Schreibrechten kann die Installation nicht ausgeführt werden.
+
wallabag installieren. Endlich.
+
Rufe wallabag in deinem Browser auf. Wenn dein Server richtig konfiguriert ist, wird die Setup-Seite angezeigt.
+
Gib dort deinen Datenbank-Typ an (sqlite, mysql oder postgresql) und die Angaben für dein Benutzerkonto
+
wallabag ist jetzt fertig installiert.
+
Anmelden
+
Rufe wallabag in deinem Webbrowser auf und gib deinen Benutzernamen und dein Passwort ein, um dich anzumelden.
Zum Lesen eines Artikels klicke einfach auf den zugehörigen Link.
+
Weiterlesen von Artikeln
+
Wenn du einen Artikel schließt, merkt sich wallabag die Stelle, an der du aufgehört hast zu lesen. So kannst du dort weiterlesen, wo du aufgehört hast.
+Das funktioniert nur in der Web-Anwendung.
+
Mögliche Aktionen für Artikel
+
Die hier beschriebenen Aktionen können mit Hilfe der am oberen Seitenrand angezeigten Symbole ausgeführt werden.
+Die Beschreibung hier orientiert sich am Theme "Baggy" (Theme ändern), die Symbole in den anderen Themes sind im Wesentlichen gleich.
+Die Aktionen in Reihenfolge der Symbole sind:
+
Den Originalartikel lesen
+
Ein Klick auf dieses Symbol öffnet den Originalartikel.
+
Artikel als gelesen markieren
+
Markiert den Artikel als gelesen und verschiebt ihn ins Archiv (zu erreichen über den Eintrag Archiv im Menü).
+Ein erneuter Klick auf das Symbol setzt den Zustand des Artikels zurück auf "ungelesen".
+
Artikel favorisieren
+
Ein Klick auf dieses Symbol markiert den Artikel als Lieblngsartikel. Eine Liste aller so favorisierten Artikel kann über den Punkt "Favoriten" im wallabag-Menü aufgerufen werden.
+
Durch einen erneuten Klick auf das Symbol kann der Favoriten-Status wieder aufgehoben werden
+
Artikel löschen
+
Löscht den Artikel aus deiner wallabag. Diese Aktion kann nicht rückgängig gemacht werden.
+
Achtung: Es wird keine Bestätigung zum Löschen angefordert!
+
Twitter
+
Teile den Titel und Link zum Original-Artikel auf Twitter.
+
Per E-Mail
+
Teile den Titel und Link zum Original-Artikel per E-Mail.
+
Artikel drucken
+
Öffnet den Druckdialog des Browsers zum Drucken des Artikels.
+
EPUB erstellen
+
Wandelt den Artikel ins EPUB-Format um. Eine genauere Beschreibung dazu gibt es im Kapitel (ePub erstellen).
+
Fehlerhafte Anzeige des Artikels melden
+
Hiermit kann gemeldet werden, dass der Artikel nicht wie erwartet angezeigt wird. Eine genauere Beschreibung dazu gibt es im Kapitel Eine vollständige oder Kapitel existieren.
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/de/Anwender/den_ersten_artikel_speichern.html b/docs/de/Anwender/den_ersten_artikel_speichern.html
new file mode 100644
index 000000000..33aad8e80
--- /dev/null
+++ b/docs/de/Anwender/den_ersten_artikel_speichern.html
@@ -0,0 +1,175 @@
+
+
+
+
+
+
+ wallabag - Den ersten Artikel speichern
+
+
+
+
+
+
+
+
+
+
+
+ wallabag
+
+ Den ersten Artikel speichern
+
+
+ EN - FR - DE - RU
+
+
+
+
+
+
+
+
+
+
+
+
+
Den ersten Artikel speichern
+
Einmal angemeldet, gibt es viele Möglichkeiten, Artikel zu speichern.
+
In der Webanwendung
+
Klicke in der Menüleiste auf den Eintrag "Speichere einen Link", gib in das erscheinende Popup-Fenster den Link ein und klicke auf "Link speichern!".
+
Das Standardverhalten von wallabag ist, nur den Text des Artikels zu speichern. Wenn du möchtest, dass wallabag auch Kopien der im Artikel enthaltenen Bilder auf deinem Server speichert, musst du die Einstellung DOWNLOAD_PICTURES aktivieren. Lies dazu das Kapitel über die versteckten Einstellungen.
Ein Bookmarklet (auch Favelet) ist ein kleines in JavaScript geschriebenes Makro, das als Bookmark abgespeichert wird und dadurch die Funktionen eines Webbrowsers erweitert.
+
Auf deinem Smartphone
+
Vorbereitung
+
Um Artikel vom Smartphone aus zu lesen, musst du in den wallabag-Einstellungen RSS-Feeds aktivieren. Nach der Aktivierung werden benötigte Informationen wie das Sicherheits-Token angezeigt. Weiterführende Informationen findest du im Kapitel über RSS-Feeds.
+
Android
+
Installation und Konfiguration
+
Du findest die wallabag-Android-App im Google Play Store oder bei F-droid. Es gibt keinen Unterschied zwischen der im Google Play Store und der bei F-Droid angebotenen Version.
+
Nach der Installation musst du auf Einstellungen tippen, deine wallabag URL (gesamte Adresse deiner wallabag-Installation oder deines Framabag-Kontos) und deine User ID (im Normalfall 1) in die entsprechenden Felder eingeben. Wenn du mehrere Accounts angelegt hast, musst du den Account angeben, mit dem du die App verbinden willst, sowie das zugehörige Sicherheits-Token (achte darauf, alle Buchstaben und Ziffern des Tokens anzugeben, so wie es auf der Konfigurationsseite von wallabag angegeben ist).
+
Einen Artikel speichern
+
Wenn du alles richtig eingestellt hast, kannst du beim Surfen im Webbrowser Artikel ganz einfach speichern. Wähle im Teilen-Menü deines Browsers den Eintrag Bag it! und der Artikel wir deiner wallabag hinzugefügt.
+
Lesen
+
Um die Liste deiner Artikel zu laden, klicke in der wallabag-App auf Synchronisieren. Die Artikel werden nun auf dein Telefon heruntergeladen. Nun brauchst du zum Lesen der Artikel keine Internetverbindung mehr. Klicke auf Artikelliste, um einen Artikel zum Lesen auszuwählen.
+
Am Ende jedes Artikels wird eine Als gelesen markieren-Schaltfläche angezeigt, mit der der Artikel archiviert werden kann.
+
Momentan funktioniert die Synchronisation nur in eine Richtung (von wallabag zur Android-App), so dass auf dem Smartphone archivierte Artikel nicht auch in wallabag auf dem Server archiviert werden.
+
iOS
+
Installation und Konfiguration
+
Du kannst die wallabag App im AppStore herunterladen.
+
Nach der Installation kannst du die App mit deiner wallabag verbinden, indem du folgende Daten konfigurierst: deine wallabag URL (gesamte Adresse deiner wallabag-Installation oder deines Framabag-Kontos) und deine User ID (im Normalfall 1) in die entsprechenden Felder eingeben. Wenn du mehrere Accounts angelegt hast, musst du den Account angeben, mit dem du die App verbinden willst, sowie das zugehörige Sicherheits-Token (achte darauf, alle Buchstaben und Ziffern des Tokens anzugeben, so wie es auf der Konfigurationsseite von wallabag angegeben ist).
+
Anwendung
+
Nach erfolgreicher Konfiguration werden deine Artikel in die App geladen und in der Liste angezeigt (Ziehe diese Liste mit der pull-to-refresh Geste herunter, um ein manuelles Update zu starten). Alle geladenen Artikel stehen in der App nun auch offline zur Verfügung.
+
Zurzeit können Artikel leider nur lokal als gelesen markiert werden (es wird nicht mit der wallabag synchronisiert).
+
Artikel speichern
+
Artikel können z.B. vom Safari-Browser aus in deine wallabag gespeichert werden. Wähle dazu einfach im Teilen-Menü den eintrag Bag it! aus (falls du das wallabag Icon nicht findest, aktiviere es unter Mehr). Wenn alles richtig eingestellt ist wird dein Artikel gespeichert.
+
Windows Phone
+
Installation und Konfiguration
+
Du kannst die Windows Phone-App aus dem Windows Store oder direkt aus dem Store deines Smartphones.
+
Nach der Installation wirst du über eine Benachrichtigung dazu aufgefordert, die App zu konfigurieren. Öffne den Einstellungen-Abschnitt der App, indem du das Drei-Punkte-Menü am unteren Rand des Bildschirms. Gib nun die URL (gesamte Adresse deiner wallabag-Installation oder deines Framabag-Kontos) und deine User ID (im Normalfall 1) in die entsprechenden Felder ein.
+
Wenn du mehrere Accounts angelegt hast, musst du den Account angeben, mit dem du die App verbinden willst, sowie das zugehörige Sicherheits-Token (achte darauf, alle Buchstaben und Ziffern des Tokens anzugeben, so wie es auf der Konfigurationsseite von wallabag angegeben ist).
+
Mit dem Browser
+
Firefox
+
Lade das Firefox-Addon von addons.mozilla.org herunter und installiere es.
+
Gib die URL deiner wallabag-Installation oder deines Framabag-Kontos ein den Einstellungen des Addons ein.
+
Um das Addon zu nutzen, musst du die Werkzeugleiste von Firefox anpassen (Menü>Anpassen) und das wallabag (W)-Icon hinzufügen. Um einen Artikel zu speichern, klicke auf dieses wallabag-Icon. Ein neues Fenster wird geöffnet, der Artikel wird deiner wallabag hinzugefügt und das Fenster automatisch wieder geschlossen. Das funktioniert am Besten, wenn du bereits in deiner wallabag angemeldet bist, ansonsten kannst du das in dem gerade geöffneten Fenster nachholen.
+
Chrome
+
Lade das Chrome-Addon aus dem Chrome-Webstore herunter und installiere es.
+
Gib die URL deiner wallabag-Installation oder deines Framabag-Kontos ein den Einstellungen des Addons ein.
+
Während der Installation wird in der Chrome-Werkzeugleiste ein neues W-Icon erscheinen. Ein neues Fenster wird geöffnet, der Artikel wird deiner wallabag hinzugefügt und das Fenster automatisch wieder geschlossen. Das funktioniert am Besten, wenn du bereits in deiner wallabag angemeldet bist, ansonsten kannst du das in dem gerade geöffneten Fenster nachholen.
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/de/Anwender/ein_artikel_wird_nicht_korrekt_angezeigt.html b/docs/de/Anwender/ein_artikel_wird_nicht_korrekt_angezeigt.html
new file mode 100644
index 000000000..99b9b22ee
--- /dev/null
+++ b/docs/de/Anwender/ein_artikel_wird_nicht_korrekt_angezeigt.html
@@ -0,0 +1,150 @@
+
+
+
+
+
+
+ wallabag - Ein Artikel wird nicht korrekt angezeigt
+
+
+
+
+
+
+
+
+
+
+
+ wallabag
+
+ Ein Artikel wird nicht korrekt angezeigt
+
+
+ EN - FR - DE - RU
+
+
+
+
+
+
+
+
+
+
+
+
+
Ein Artikel wird nicht korrekt angezeigt
+
Wenn du meinst, dass wallabag einen Artikel nicht korrekt anzeigt (z.B. fehlender oder unvollständiger Text, nur eine von mehreren Artikelseiten oder störende Werbung im Text), gibt es mehrere Möglichkeiten, wie du helfen kannst, wallabag besser zu machen.
+
Melden des Anzeigeproblems
+
Egal ob du uns per Mail oder über ein Ticket auf GitHub über die fehlerhafte Anzeige informierst: folgende Angaben helfen uns, das Problem zu lösen.
+
+
Die URL des Artikels.
+
Wie stellt wallabag den Artikel momentan dar?
+
Was hättest du stattdessen erwartet?
+
Deine wallabag-Version bzw. ob du Framabag verwendest.
+
+
Variante 1: Ein Ticket auf GitHub eröffnen
+
Um ein Ticket auf GitHub zu eröffnen, benötigst du dort ein Benutzerkonto. Bitte vergiss nicht, in der Ticketbeschreibung die oben genannten Angaben zu machen.
+Danke!
+
Variante 2: E-Mail
+
Sende uns eine E-Mail mit dem Betreff Wrong display in wallabag an [hello@wallabag.org](mailto: hello@wallabag.org).
+Bitte vergiss nicht, in der E-Mail die oben genannten Angaben zu machen.
+Danke!
Damit die gespeicherten Artikel auch bei langen Winterabenden unter dem Leselicht genossen werden können, kann wallabag sie in ein E-Book im EPUB-Format umwandeln.
+
Warnung
+
Bitte beachte jedoch, dass das Erstellen der EPUB-Datei sehr ressourcenintensiv für den Server, auf dem wallabag installiert ist, sein kann.
+Es hängt von der Anzahl der Elemente und deren Länge ab. Daher ist es empfehlenswert, keine übermäßig großen E-Books zu erstellen, sofern dies nicht erforderlich ist.
+
Wo kann ich meine Artikel konvertieren?
+
Sie können Ihre Artikel aus verschiedenen Orten in wallabag konvertieren:
+
+
Bei dem Lesen eines Artikel: wallabag wird nur diesen einen Artikel konvertieren.
+
Bei einer Artikelliste (ungelesen, Favoriten, Archiv): Alle Artikel aus dieser Kategorie werden konvertiert.
+
Aus der Suche heraus: Am Ende der Seite ist ein Link, der alle Suchergebnisse konvertiert.
+
Auf der Konfigurationsseite: Alle Artikel, egal welche Kategorie, können hier in ein E-Book konvertiert werden.
Da du eventuell dich nicht das Wissen hast, um wallabag zu installieren, oder nicht für Installation und Aktualisierung zuständig sein möchtest, ist es möglich, ein kostenloses Konto bei Framabag.org zu erstellen.
+
Benutzerkonto erstellen
+
Klicke auf die Schaltfläche Créez votre compte / Create your account.
+Danach musst du einige Informationen angeben: Benutzernamen, Passwort und E-Mail-Adresse. Deine E-Mail-Adresse wird nur dazu verwendet, um dein Konto zu bestätigen oder wenn du den Newsletter (3-4 E-Mails jährlich) abonniert hast.
+
Sobald alle Daten überprüft worden, erhältst du eine E-Mail mit einem Bestätigungslink. Klicke darauf, um das Konto zu erstellen.
+
Du wirst eine letzte E-Mail mit der Adresse deines Framabag-Kontos in dieser Form https://www.framabag.org/u/votre-nom-d'utilisateur.
+
Speicherung Ihrer Daten
+
Framabag verwendet eine Benutzerdatenbank. Aber wir werden keinen Gebrauch von deinen Daten machen.
+
Passwort vergessen
+
Wenn du dein Passwort vergessen hast, um dich mit Framabag zu verbinden, ist ein Formular auf der Service-Homepage verfügbar.
+Du erhältst einen Bestätigungslink und kannst über ihn dein neues Passwort festlegen.
+
Löschen des Kontos
+
Wenn du dein Konto löschen möchtest, kontaktiere uns per E-Mail: [hello@wallabag.org](mailto: hello@wallabag.org)
+Gib hierbei deinen Benutzernamen an, damit wir dich identifizieren können.
+
Von dem Moment an, wo dein Konto gelöscht wurde, werden keine weiteren Informationen über dich auf Framabag gespeichert werden.
Dieser Teil ist nur für fortgeschrittene Anwender.
+Solltest du beim Bearbeiten einer der Dateien etwas falsch machen, kann es sein, dass wallabag nicht mehr funktioniert.
+Es muss eine wichtige Datei von wallabag bearbeitet werden, inc/poche/config.inc.php, deshalb mache unbedingt eine Sicherungskopie dieser Datei, bevor du etwas änderst!
+
Die Datei wird während der Installation von wallabag erzeugt und mit Standardeinstellungen initialisiert. Durch Anpassen der Datei kann das Verhalten von wallabag in einigen Punkten angepasst werden, die nicht über die nicht über der Konfigurationsseite verfügbar sind.
+
Fortgeschrittene Einstellungen
+
Jeder der in inc/poche/config.inc.php definierten Parameter ist folgendermaßen angegeben:
+
@define ('PARAMETER_NAME', 'Parameter-Wert');
+
Es darf in jeder Zeile ausschließlich Parameter-Wert geändert werden.
+Ändere keine anderen in der Datei angegebenen Parameter!
+
Änderbare Parameter:
+
+
+
+
PARAMETER_NAME
+
Standardwert
+
Beschreibung
+
erwarteter Wert
+
+
+
+
+
HTTP_PORT
+
80
+
entspricht dem HTTP-Port auf deinem Webserver. Nur ändern, wenn sich dein Web-Server hinter einem Proxy befindet.
+
ganze Zahl
+
+
+
SSL_PORT
+
443
+
entspricht dem SSL-Port auf deinem Webserver. Ändern, wenn du sslh verwendest.
+
ganze Zahl
+
+
+
DEBUG_POCHE
+
FALSE
+
Wenn du Probleme mit wallabag hast, kann es bei der Fehlersuche helfen, den Debug-Modus zu aktivieren.
+
TRUE / FALSE
+
+
+
DOWNLOAD_PICTURES
+
FALSE
+
Damit kannst du Bilder aus Artikeln herunterladen (zusätzlich zum Artikeltext). Diese Einstellung ist standardmäßig deaktiviert, um eine Überlastung des Webservers zu vermeiden. Wir bevorzugen, dich diese Einstellung selbst aktivieren zu lassen.
+
TRUE / FALSE
+
+
+
SHARE_TWITTER
+
TRUE
+
ermöglicht die gemeinsame Nutzung mit Twitter
+
TRUE / FALSE
+
+
+
SHARE_MAIL
+
TRUE
+
ermöglicht den Austausch per E-Mail
+
TRUE / FALSE
+
+
+
SHARE_SHAARLI
+
FALSE
+
ermöglicht die gemeinsame Nutzung mit einer Shaarli-Installation (ein Lesezeichen-Manager)
+
TRUE / FALSE
+
+
+
SHAARLI_URL
+
'http://myshaarliurl.com'
+
Definiert die URL Ihrer Installation Shaarli.
+
URL
+
+
+
FLATTR
+
TRUE
+
Aktiviert die Möglichkeit, einen Artikel zu flattrn ([Flattr ist eine Plattform für Mikrospenden] (http://de.wikipedia.org/wiki/Flattr)). Wenn ein Artikel flattrbar ist, wird ein Symbol angezeigt und ermöglicht es, eine Mikro-Spende an den Autor des Artikels zu senden.
+
TRUE / FALSE
+
+
+
SHOW_PRINTLINK
+
'1'
+
Zeigt eine Link, um einen Artikel zu drucken.
+
'0' (deaktiviert), '1' (aktiviert)
+
+
+
SHOW_READPERCENT
+
'1'
+
Zeige den bereits gelesenen Anteil im Artikel (nur bei den Themes default, dark, dmagenta, solarized, solarized-dark).
+
'0' (deaktiviert), '1' (aktiviert)
+
+
+
PAGINATION
+
'12'
+
Definiert die Anzahl der Einträge, die auf einer Seite dargestellt werden.
Auf Konfigurationsseite kannst du die Einstellungen von wallabag anpassen.
+
Einige Punkte der Konfigurationsseite werden hier nicht beschrieben, da für diese eigene Kapitel in der Dokumentation vorgesehen sind (RSS-Feeds, Import von einem Drittanbieter, Datenexport, EPUB-Konvertierung und Mehrbenutzermodus)
+
Themes
+
Über Geschmack lässt sich nicht streiten. Deshalb lässt dir wallabag die Wahl zwischen verschiedenen Themes, um das Aussehen deinem Geschmack anzupassen.
+
Wähle ein Theme aus der Auswahlliste und bestätige die Änderung durch einen Klick auf Aktualisieren.
+
Sprache
+
Wähle die Sprache deiner Wahl in der Auswahlliste und bestätige die Änderung durch Klick auf Aktualisieren.
+
Passwort
+
Um dein Passwort zu ändern, gib es in die zwei vorgesehenen Felder ein und bestätige die Änderung durch Klick auf Aktualisieren.
+
Du wirst abgemeldet und musst für eine erneute Anmeldung dein neues Passwort nutzen.
+
Den Cache leeren
+
Mit Hilfe des Caches kann wallabag einige Aufgaben schneller erledigen.
+
Nach einem Update von wallabag sollte der Cache geleert werden. Klicke dazu auf den entsprechenden Link.
Zum Lesen eines Artikels klicke einfach auf den zugehörigen Link.
-
Weiterlesen von Artikeln
-
Wenn du einen Artikel schließt, merkt sich wallabag die Stelle, an der du aufgehört hast zu lesen. So kannst du dort weiterlesen, wo du aufgehört hast.
-Das funktioniert nur in der Web-Anwendung.
-
Mögliche Aktionen für Artikel
-
Die hier beschriebenen Aktionen können mit Hilfe der am oberen Seitenrand angezeigten Symbole ausgeführt werden.
-Die Beschreibung hier orientiert sich am Theme "Baggy" (Theme ändern), die Symbole in den anderen Themes sind im Wesentlichen gleich.
-Die Aktionen in Reihenfolge der Symbole sind:
-
Den Originalartikel lesen
-
Ein Klick auf dieses Symbol öffnet den Originalartikel.
-
Artikel als gelesen markieren
-
Markiert den Artikel als gelesen und verschiebt ihn ins Archiv (zu erreichen über den Eintrag Archiv im Menü).
-Ein erneuter Klick auf das Symbol setzt den Zustand des Artikels zurück auf "ungelesen".
-
Artikel favorisieren
-
Ein Klick auf dieses Symbol markiert den Artikel als Lieblngsartikel. Eine Liste aller so favorisierten Artikel kann über den Punkt "Favoriten" im wallabag-Menü aufgerufen werden.
-
Durch einen erneuten Klick auf das Symbol kann der Favoriten-Status wieder aufgehoben werden
-
Artikel löschen
-
Löscht den Artikel aus deiner wallabag. Diese Aktion kann nicht rückgängig gemacht werden.
-
Achtung: Es wird keine Bestätigung zum Löschen angefordert!
-
Twitter
-
Teile den Titel und Link zum Original-Artikel auf twitter.
-
Per E-Mail
-
Teile den Titel und Link zum Original-Artikel per E-Mail.
-
Artikel drucken
-
Öffnet den Druckdialog des Browsers zum Drucken des Artikels.
-
ePub erstellen
-
Wandelt den Artikel ins ePub-Format um. Eine genauere Beschreibung dazu gibt es im Kapitel (ePub erstellen.
-
Fehlerhafte Anzeige des Artikels melden
-
Hiermit kann gemeldet werden, dass der Artikel nicht wie erwartet angezeigt wird. Eine genauere Beschreibung dazu gibt es im Kapitel Eine vollständige oder Kapitel existieren.
Einmal angemeldet, gibt es viele Möglichkeiten, Artikel zu speichern.
-
In der Webanwendung
-
Klicke in derMenüleiste auf den Eintrag "Speichere einen Link", gib in das erscheinende Popup-Fenster den Link ein und klicke auf "Link speichern!".
-
Das Standardverhakten von wallabag ist, nur den Text des Artikels zu speichern. Wenn du möchtest, dass wallabag auch Kopien der im Artikel enthaltenen Bilder auf deinem Server speichert, musst du die Einstellung DOWNLOAD_PICTURES aktivieren. Lies dazu das Kapitel über die versteckten Einstellungen.
Ein Bookmarklet (auch Favelet) ist ein kleines in JavaScript geschriebenes Makro, das als Bookmark abgespeichert wird und dadurch die Funktionen eines Webbrowsers erweitert.
-
Auf deinem Smartphone
-
Vorbereitung
-
Um Artikel vom Smartphone aus zu lesen, musst du in den wallabag-Einstellungen RSS-Feeds aktivieren. Nach der Aktivierung werden benötigte Informationen wie das Sicherheits-Token angezeigt. Weiterführende Informationen findest du im Kapitel über RSS-Feeds.
-
Android
-
Installation und Konfiguration
-
Du findest die wallabag-Android-App im Google Play Store oder bei F-droid. Es gibt keinen Unterschied zwischen der im Google Play Store und der bei F-Droid angebotenen Version.
-
Nach der Installation musst du auf Einstellungen tippen, deine wallabag URL (gesamte Adresse deiner wallabag-Installation oder deines Framabag-Kontos) und deine User ID (im Normalfall 1) in die entsprechenden Felder eingeben. Wenn du mehrere Accounts angelegt hast, musst du den Account angeben, mit dem du die App verbinden willst, sowie das zugehörige Sicherheits-Token (achte darauf, alle Buchstaben und Ziffern des Tokens anzugeben, so wie es auf der Konfigurationsseite von wallabag angegeben ist).
-
Einen Artikel speichern
-
Wenn du alles richtig eingestellt hast, kannst du beim Surfen im Webbrowser Artikel ganz einfach speichern. Wähle im Teilen-Menü deines Browsers den Eintrag Bag it! und der Artikel wir deiner wallabag hinzugefügt.
-
Lesen
-
Um die Liste deiner Artikel zu laden, klicke in der wallabag-App auf Synchronisieren. Die Artikel werden nun auf dein Telefon heruntergeladen. Nun brauchst du zum Lesen der Artikel keine Internetverbindung mehr. Klicke auf Artikelliste, um einen Artikel zum Lesen auszuwählen.
-
Am Ende jedes Artikels wird eine Als gelesen markieren-Schaltfläche angezeigt, mit der der Artikel archiviert werden kann.
-
Momentan funktioniert die Synchronisation nur in eine Richtung (von wallabag zur Android-App), so dass auf dem Smartphone archivierte Artikel nicht auch in wallabag auf dem Server archiviert werden.
-
iOS
-
Installation und Konfiguration
-
TODO
-
Anwendung
-
TODO
-
Windows Phone
-
Installation und Konfiguration
-
Du kannst die Windows Phone-App aus dem Windows Store oder direkt aus dem Store deines Smartphones.
-
Nach der Installation wirst du über eine Benachrichtigung dazu aufgefordert, die App zu konfigurieren. Öffne den Einstellungen-Abschnitt der App, indem du das Drei-Punkte-Menü am unteren Rand des Bildschirms. Gib nun die URL (gesamte Adresse deiner wallabag-Installation oder deines Framabag-Kontos) und deine User ID (im Normalfall 1) in die entsprechenden Felder ein.
-
Wenn du mehrere Accounts angelegt hast, musst du den Account angeben, mit dem du die App verbinden willst, sowie das zugehörige Sicherheits-Token (achte darauf, alle Buchstaben und Ziffern des Tokens anzugeben, so wie es auf der Konfigurationsseite von wallabag angegeben ist).
-
Mit dem Browser
-
Firefox
-
Lade das Firefox-Addon von addons.mozilla.org herunter und installiere es.
-
Gib die URL deiner wallabag-Installation oder deines Framabag-Kontos ein den Einstellungen des Addons ein.
-
Um das Addon zu nutzen, musst du die Werkzeugleiste von Firefox anpassen (Menü>Anpassen) und das wallabag (W)-Icon hinzufügen. Um einen Artikel zu speichern, klicke auf dieses wallabag-Icon. Ein neues Fenster wird geöffnet, der Artikel wird deiner wallabag hinzugefügt und das Fenster automatisch wieder geschlossen. Das funktioniert am Besten, wenn du bereits in deiner wallabag angemeldet bist, ansonsten kannst du das in dem gerade geöffneten Fenster nachholen.
-
Chrome
-
Lade das Chrome-Addon aus dem Chrome-Webstore herunter und installiere es.
-
Gib die URL deiner wallabag-Installation oder deines Framabag-Kontos ein den Einstellungen des Addons ein.
-
Während der Installation wird in der Chrome-Werkzeugleiste ein neues W-Icon erscheinen. Ein neues Fenster wird geöffnet, der Artikel wird deiner wallabag hinzugefügt und das Fenster automatisch wieder geschlossen. Das funktioniert am Besten, wenn du bereits in deiner wallabag angemeldet bist, ansonsten kannst du das in dem gerade geöffneten Fenster nachholen.
Ein Artikel wird nicht korrekt angezeigt Fix this page
-
- Thursday, November 20, 2014
-
- 11:43 AM
-
-
-
Wenn du meinst, dass wallabag einen Artikel nicht korrekt anzeigt (z.B. fehlender oder unvollständiger Text, nur eine von mehreren Artikelseiten oder störende Werbung im Text), gibt es mehrere Möglichkeiten, wie du helfen kannst, wallabag besser zu machen.
-
Melden des Anzeigeproblems
-
Egal ob du uns per Mail oder über ein Ticket auf GitHub über die fehlerhatfte Anzeige informierst: folgende Angaben helfen uns, das Problem zu lösen.
-
-
die URL des Artikels
-
wie stellt wallabag den Artikel momentan dar?
-
was hättest du stattdessen erwartet?
-
deine wallabag-Version bzw. ob du Framabag verwendest
-
Variante 1: Ein Ticket auf GitHub eröffnen
-
Um ein Ticket auf GitHub zu eröffnen, benötigst du dort ein Benutzerkonto. Bitte vergiss nicht, in der Ticketbeschreibung die oben genannten Angaben zu machen.
-Danke!
-
-
Variante 2: E-Mail
-
Sende uns eine E-Mail mit dem Betreff Falsche Anzeige in wallabag an hello@wallabag.org.
-Bitte vergiss nicht, in der E-Mail die oben genannten Angaben zu machen.
-Danke!
Wenn du wallabag nicht auf einem eigenen Server installieren kannst oder möchtest, solltest du ein kostenloses Benutzerkonto auf Framabag erstellen, wo wallabag genutzt wird.
Um zu überprüfen, ob dein Server die Voraussetzungen erfüllt, kannst du wallabag_compatibility_test.php ausführen. Diese Datei liegt im install-Verzeichnis von wallabag.
-
Installation der Abhängigkeiten
-
Damit wallabag ordnungsgemäß funktioniert, müssen einige Abhängigkeiten erfüllt werden. Um diese zu installieren, muss composer verwendet werden. Führe folgende Kommandos in deinem wallabag-Verzeichnis aus:
Falls du composer nicht installieren kannst, kannst du alternativ vendor.zip herunterladen und in deinem wallabag-Verzeichnis entpacken.
-
Berechtigungen
-
Dein Webserver braucht Schreibrechte in den Verzeichnissen assets, cache, und db. Bei fehlenden Schreibrechten kann die Installation nicht ausgeführt werden.
-
wallabag installieren. Endlich.
-
Rufe wallabag in deinem Browser auf. Wenn dein Server richtig konfiguriert ist, wird die Setup-Seite angezeigt.
-
Gib dort deinen Datenbank-Typ an (sqlite, mysql oder postgresql) und die Angaben für dein Benutzerkonto
-
wallabag ist jetzt fertig installiert.
-
Anmelden
-
Rufe wallabag in deinem Webbrowser auf und gib deinen Benutzernamen und dein Passwort ein, um dich anzumelden.
Dieser Teil ist nur für fortgeschrittene Anwender.
-Solltest du beim Bearbeiten einer der Dateien etwas falsch machen, kann es sein, dass wallabag nicht mehr funktioniert.
-Es muss eine wichtige Datei von wallabag bearbeitet werden, inc/poche/config.inc.php, deshalb mache unbedingt eine Sicherungskopie dieser Datei, bevor du etwas änderst!
-
Die Datei wird während der Installation von wallabag erzeugt und mit Standardeinstellungen initialisiert. Durch Anpassen der Datei kann das Verhalten von wallabag in einigen Punkten angepasst werden, die nicht über die nicht über der Konfigurationsseite verfügbar sind.
-
Fortgeschrittene Einstellungen
-
Jeder der in inc/poche/config.inc.php definierten Parameter ist folgendermaßen angegeben:
-
@define ('PARAMETER_NAME', 'Parameter-Wert');
-
Es darf in jeder Zeile ausschließlich Parameter-Wert geändert werden.
-Ändere keine anderen in der Datei angegebenen Parameter!
-
Änderbare Parameter:
-
-
-
-
PARAMETER_NAME
-
Standardwert
-
Beschreibung
-
erwarteter Wert
-
-
-
-
-
HTTP_PORT
-
80
-
entspricht dem HTTP-Port auf deinem Webserver. Nur ändern, wenn sich dein Web-Server hinter einem Proxy befindet.
-
ganze Zahl
-
-
-
SSL_PORT
-
443
-
entspricht dem SSL-Port auf deinem Webserver. Ändern, wenn du sslh verwendest.
-
ganze Zahl
-
-
-
DEBUG_POCHE
-
FALSE
-
Wenn du Probleme mit wallabag hast, kann es bei der Fehlersuche helfen, den Debug-Modus zu aktivieren.
-
TRUE / FALSE
-
-
-
DOWNLOAD_PICTURES
-
FALSE
-
Damit kannst du Bilder aus Artikeln herunterladen (zusätzlich zum Artikeltext). Diese Einstellung ist standardmäßig deaktiviert, um eine Überlastung des Webservers zu vermeiden. Wir bevorzugen, dich diese Einstellung selbst aktivieren zu lassen.
-
TRUE / FALSE
-
-
-
SHARE_TWITTER
-
TRUE
-
ermöglicht die gemeinsame Nutzung mit Twitter
-
TRUE / FALSE
-
-
-
SHARE_MAIL
-
TRUE
-
ermöglicht den Austausch per E-Mail
-
TRUE / FALSE
-
-
-
SHARE_SHAARLI
-
FALSE
-
ermöglicht die gemeinsame Nutzung mit einer Shaarli-Installation (ein Lesezeichen-Manager)
-
TRUE / FALSE
-
-
-
SHAARLI_URL
-
'http://myshaarliurl.com'
-
Definiert die URL Ihrer Installation Shaarli.
-
URL
-
-
-
FLATTR
-
TRUE
-
Aktiviert die Möglichkeit, einen Artikel zu flattrn ([Flattr ist eine Plattform für Mikrospenden] (http://de.wikipedia.org/wiki/Flattr)). Wenn ein Artikel flattrbar ist, wird ein Symbol angezeigt und ermöglicht es, eine Mikro-Spende an den Autor des Artikels zu senden.
-
TRUE / FALSE
-
-
-
SHOW_PRINTLINK
-
'1'
-
Zeigt eine Link, um einen Artikel zu drucken.
-
'0' (deaktiviert), '1' (aktiviert)
-
-
-
SHOW_READPERCENT
-
'1'
-
Zeige den bereits gelesenen Anteil im Artikel (nur bei den Themes default, dark, dmagenta, solarized, solarized-dark).
-
'0' (deaktiviert), '1' (aktiviert)
-
-
-
PAGINATION
-
'12'
-
Definiert die Anzahl der Einträge, die auf einer Seite dargestellt werden.
Auf Konfigurationsseite kannst du wallabags Einstellungen anpassen.
-
Einige Punkte der Konfigurationsseite werden hier nicht beschrieben, da für diese eigene Kapitel in der Dokumentation vorgesehen sind (RSS-Feeds, Import von einem Drittanbieter, Datenexport, epub-Konvertierung und Mehrbenutzermodus)
-
Themes
-
Über Geschmack lässt sich nicht streiten. Deshalb lässt dir wallabag die Wahl zwischen verschiedenen Themes, um das Aussahen deinem Geschmack anzupassen.
-
Wähle ein Theme aus der Auwahlliste und bestätige die Änderung durch einen Klick auf Aktualisieren.
-
Sprache
-
Wähle die Sprache deiner Wahl in der Auswahlliste und bestätige die Änderung durch Klick auf Aktualisieren.
-
Passwort
-
Um dein Passwort zu ändern, gib es in die zwei vorgesehenen Felder ein und bestätige die Änderung durch Klick auf Aktualisieren.
-
Du wirst abgemeldet und musst für eine erneute Anmeldung dein neues Passwort nutzen.
-
Den Cache leeren
-
Mit Hilfe des Caches kann wallabag einige Aufgaben schneller erledigen.
-
Nach einem Update von wallabag sollte der Cache geleert werden. Klicke dazu auf den entsprechendenLink.
wallabag ist eine Read-it-later-Anwendung: sie speichert Webseiten, indem sie lediglich die Inhalte behält. Elemente wie Navigations-Links und Werbung werden entfernt.
-
Funktionen
-
-
Inhalte der Webseiten werden gespeichert: Texte und Bilder
-
die Webanwendung passt sich dem benutzten Anzeigegerät (Smartphone, PC, ... ) an
-
Artikel können als ePub exportiert werden
-
dank Smartphone-Apps können Artikel auch offline gelesen werden
-
dank Browser-Addons können neue Links schnell hinzugefügt werden
-
viele Templates zur individuellen Anpassung des Erscheinungsbild von wallabag sind verfügbar
-
... und viele weitere Funktionen!
-
-
Diese Anwenderdokumentation soll zeigen, wie man wallabag nutzen kann.
-
Demonstration
-
Wenn du alle wallabag-Funktionen ausprobieren möchtest, kannst du diese Demonstrations-Webseite nutzen: http://demo.wallabag.org
-
Ein Benutzerkonto erstellen
-
Wenn du wallabag nicht selbst installieren möchtest oder kannst, kannst du stattdessen ein kostenloses Benutzerkonto auf Framabag.org erstellen. Dazu brauchst du nur eine gültige E-Mail-Adresse.
wallabag ist eine Read-it-later-Anwendung: sie speichert Webseiten, indem sie lediglich die Inhalte behält. Elemente wie Navigations-Links und Werbung werden entfernt.
+
Funktionen
+
+
Inhalte der Webseiten werden gespeichert: Texte und Bilder
+
die Webanwendung passt sich dem benutzten Anzeigegerät (Smartphone, PC, ... ) an
+
Artikel können als ePub exportiert werden
+
dank Smartphone-Apps können Artikel auch offline gelesen werden
+
dank Browser-Addons können neue Links schnell hinzugefügt werden
+
viele Templates zur individuellen Anpassung des Erscheinungsbild von wallabag sind verfügbar
+
... und viele weitere Funktionen!
+
+
Diese Anwenderdokumentation soll zeigen, wie man wallabag nutzen kann.
Es ist gar nicht schwer: sprich einfach über wallabag! Benutze den #wallabag-Hashtag in sozialen Netzwerken: twitter, Facebook, Diaspora*, Google+, etc.
If you can't or don't want to install Wallabag on your server, we suggest you create a free account on Framabag wich uses our software: read the complete documentation here (TODO write Create a framabag account).
+
I want to install wallabag
+
I want to download wallabag the easiest way possible
Your web server needs a writing access to the assets, cache and db directories. Otherwise, a message will report that the installation is impossible.
+
Installation of wallabag. At last.
+
Access to wallabag from your web browser. If your server is correctly configured, you directly reach the setup screen.
+
Prerequisites
+
The installer will tell you which prerequisites are missing. If there's any, jump off to the corresponding session to know how to deal with that problem.
+
Twig installation
+
wallabag is build with Twig, a template library. You have to download it for wallabag to work.
+
+
One option is to choose the automatic download of the package which will be automatically downloaded and installed.
+
If this option fails, you can choose the second option which is to manually download the vendor package, unzip it and copy the vendor directory in your wallabag directory
+
+
Finally, you can here also use Composer to install Twig by following the commands written on screen :
SQLite: The easiest system of all. No extra configuration needed.
+
MySQL: A well known database system, which is in most cases more efficient than SQLite
+
Postgresql: Some people found it better than MySQL.
+
+
Note : If you're using MySQL or Postgresql, you have to fill all the fields, otherwise the installation will not work and an error message will tell you what's wrong. You must create the database that you will use for wallabag manually with a tool like PHPMyAdmin or the console.
+
User Account
+
Finally, you need to create an user account. As always, be sure to choose a strong password.
+An email field is present but it is not at all required.
+
If you get a green success message, it means wallabag is now installed.
Be careful, this section is destined to advanced users. We are going to modify an important wallabag configuration file, inc/poche/config.inc.php. It is therefore advised to do a backup of this file before you proceed.
+Any error occuring during the modification of a wallabag file could lead to malfunctions.
+
This file is created when you install wallabag.
+Install wallabag, do a backup copy of the file, then open it in your favorite text editor.
+
In this file, there are some options that are not, as of now, available in the config page of wallabag.
+
Modification of advanced options
+
Each option is defined this way:
+
@define ('OPTION_NAME', 'Value');
+
For each line, you can only modify the Value field.
+
Here is the list of each option you can change:
+
+
HTTP_PORT (default: 80) : the HTTP port of your web server. You may need to change it if your server is behind a proxy. Accepted values: number
+
SSL_PORT (default: 443) : the HTTP port of your web server. You may need to change it if your server use SSLH. Accepted values: number
+
MODE_DEMO (default : FALSE): If you ever wanted to set up a demonstration server... Accepted values: TRUE or FALSE.
+
DEBUG_POCHE (default: FALSE) : if you encounter some problems with wallabag, we may ask you to active Debug mode. Accepted values: TRUE or FALSE. Check the logs in cache/log.txt after activating that.
+
ERROR_REPORTING (default : E_ALL & ~E_NOTICE) : Set to E_ALL if needed to look for eventual PHP errors.
+
DOWNLOAD_PICTURES (default: FALSE) : Allows wallabag to fetch images from the articles you save on your server, instead of fetching only the text. We prefer to let you activate this option yourself. Accepted values: TRUE or FALSE.
+
REGENERATE_PICTURES_QUALITY (default : 75) : In order to avoid security problems, pictures are regenerated if you activate the download of pictures. This is the percentage of quality at which they are saved. Increase that numbler if you want better quality, lower if you need better performances.
SHARE_MAIL (default: TRUE) : enables mail sharing. Accepted values: TRUE or FALSE.
+
SHARE_EVERNOTE(default : FALSE) : enables sharing with your Evernote account. Accepted values: TRUE or FALSE.
+
SHARE_DIASPORA (default : FALSE) : enables to share an article on your Diaspora account.
+
DIASPORA_URL (default : http://diasporapod.com) : The URL of your Diaspora* pod
+
CARROT (default : FALSE) : Like Flattr, it's a service to give small amounts of money to a web page. See http://carrot.org/
+
SHARE_SHAARLI (default: FALSE) : enables sharing via your Shaarli installation (Shaarli is an open-source bookmark manager). Accepted values: TRUE or FALSE.
+
SHAARLI_URL (default: 'http://myshaarliurl.com') : defines your Shaarli installation URL. Accepted values: an URL.
+
FLATTR (default: TRUE) : enables the possibility to Flattr an article (Flattr is a microdonation platform). If an article is Flattr-able, an icon will be displayed, allowing you to send a microdonation to the author. Accepted values: TRUE or FALSE.
+
SHOW_PRINTLINK (default: '1') : enables the Print button for articles. Accepted values: '1' to enable or '0' to disable.
+
SHOW_READPERCENT (default: '1') : enables the reading progress on articles (working on the default, dark, dmagenta, solarized, solarized-dark themes). Accepted values: '1' to enable or '0' to disable.
+
PAGINATION (default: '12') : defines the number of articles that are displayed on a list. Accepted values: number.
In order to update your installation, download and unzip the archive into your installation folder. For example on Ubuntu/Debian:
+
wget http://wllbg.org/latest
+unzip latest
+rsync -ur wallabag-version-number/* /var/www/html/wallabag/ # could be another location such as /srv/html, /usr/share/nginx/html
+
After that, just access wallabag in your browser and follow the instructions to finish the update.
+
You can verify at the bottom of the configuration page that you're running the last version.
+
If it fails, just delete the install folder and clear the cache:
+
cd /var/www/html/wallabag/
+rm -r cache/* install/
+
Clearing the cache is also possible in the configuration page, clicking on the link `Delete Cache.
If you wish to contribute to the project by suggesting new features or by fixing some bugs, please follow the recommendations below regarding the git repository available at https://github.com/wallabag/wallabag.
+
Current state
+
To manage the different versions of wallabag, we use Git.
+
There are multiple branches for the source code of wallabag web app:
+
+
master branch : this is the stable branch, downloaded by those who wish to install wallabag for their own use.
+
dev branch : before being added on master branch, all bug fixes and new features must go on that branch. This branch is not recommended for production use.
+
v2-symfony branch : this is the branch for a revamp of wallabag. A whole chapter is to be focused on it.
+
+
Workflow
+
All the rules for contributing to the git repository are in the CONTRIBUTING.md file of wallabag. Please read carefully this file before you make any change.
Vagrant is computer software for creating and configuring virtual development environments. It can be seen as a wrapper around virtualization software such as VirtualBox, KVM, VMware and around configuration management software such as Ansible, Chef, Salt or Puppet.
+
Use Vagrant for wallabag
+
Here is the procedure to run wallabag inside a Vagrant container:
+
wget -O wallabag-dev.zip https://github.com/wallabag/wallabag/archive/dev.zip
+unzip wallabag-dev.zip
+cd wallabag-dev
+vagrant up
+
Now, go to http://localhost:8003, wallabag should be available there! (make sure you do not use the port 8003 of your machine for something else before)
wallabag can use specific site config files to parse website articles. These files are stored in the inc/3rdparty/site_config/standard folder.
+
The format used for these files is XPath. Look at some examples in the folder.
+
Automatic config files generation
+
Fivefilters has created a very useful tool to create config files. You just type in the adress of the article to work on with, and you select the area containing the content you want.
+
+
You should confirm this area by trying with other articles.
+When you got the right area, just click on Download Full-Text RSS site config to download your file.
+
Manual config file generation
+
If Fivefilters tool doesn't work correctly, take a look at the source (Ctrl + U on Firefox and Chromium). Search for your content and get the class or the id attribute of the area containing what you want.
+
Once you've got the id or class, you can write for example one or another of these lines:
wallabag is a read-it-later application: it saves a web page by keeping content only. Elements like navigation or ads are deleted.
-
Features
-
-
content of the web page is saved: text and pictures.
-
the web application is responsive
-
you can export articles into ePub
-
you can read your articles offline thanks to smartphones applications
-
you can easily save a new link thanks to browser addons
-
many templates are available to change your wallabag as you wish
-
and many others great features !
-
-
This user documentation is here to learn to you what you can do with wallabag.
-
Demonstration
-
If you want to try all wallabag features, there is a demonstration website: http://demo.wallabag.org
-
Create an account
-
Maybe you don't want to install and update wallabag by yourself, or you can't do it, it's possible to create a free account on Framabag.org. Just your email is needed.
From the configuration menu, you can change some wallabag's options.
+
Some parts won't be presented here as they have a complete chapter in the documentation (RSS feeds, import from a third party service, export your data, Epub conversion and multi-user mode).
+
Theme
+
Of tastes and colors, we do not discuss. That's why wallabag offers you to change its skin to please everyone.
+
Select the theme of your choice from the drop down list and confirm by clicking on Update.
+
Language
+
Select the language of your choice in the drop down list and confirm by clicking on Update.
+
Password
+
Fill in your new password in the two dedicated fields and confirm by clicking on Update.
+
You will be disconnected and need to enter your new password to access your wallabag.
+
Clear the cache
+
The cache allows wallabag perform certain functions faster.
+
After updating wallabag, it is advised to clear the cache. You only have to click to do so.
To enable you to read your articles on a e-reader, wallabag can convert them to the ePub format, and hence create an eBook for your long winter evenings.
+
A word of caution
+
Be careful, the creation of ePub files can be very resource demanding for the server on which wallabag is installed.
+It depends on the number of articles and on their length.
+Do not create a really big eBook if this is not necessary.
+
Where to convert the articles
+
You can convert your articles at various places in wallabag:
+
+
on the reading page of an article: the ePub link will convert this article only
+
from the list of articles (unread, favorite or archived articles, articles with a tag): a link at the bottom of the page allows you to convert all the article of this category
+
from a search: the link is at the bottom of the page
+
from the configuration page: you can convert all your articles, whatever the category to which they belong
If you do not want to install and update wallabag, or if you do not have the know-how to install it, it is possible to create an account for free at Framabag.org.
+
Account creation
+
Click on the button Créez votre compte / Create your account.
+
You have to input some information: your username, your password and your email address. Your address is used only to validate your account, except if you check the box to subscribe the newsletter (3 to 4 messages per year).
+
Once this form validated, you will receive an email with the confirmation link. Click on it to create your account.
+
You will receive a last email with the address of your Framabag account, which will look like
+https://www.framabag.org/u/Your-username.
+
Information storage
+
Framabag use one database per user. We do not and will not use your stored data.
+
You have forgotten your password
+
If you have forgotten your password to get connected to Framabag, a form is available on the main page of the service.
+Fill it, and a confirmation will be sent to you and will allow you to input a new password.
+
Account deletion
+
If you wish to delete your account, contact us by email: hello@wallabag.org using the address your created your account with, and state your username.
+
We will answer you after your account has been deleted: then, no information about you will be stored by Framabag.
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/en/User/import_export.html b/docs/en/User/import_export.html
new file mode 100644
index 000000000..e3705147c
--- /dev/null
+++ b/docs/en/User/import_export.html
@@ -0,0 +1,244 @@
+
+
+
+
+
+
+ wallabag - Import and export data
+
+
+
+
+
+
+
+
+
+
+
+ wallabag
+
+ Import and export data
+
+
+ EN - FR - DE - RU
+
+
+
+
+
+
+
+
+
+
+
+
+
Import and export data
+
Import
+
To import data in wallabag, go to the page Configuration.
+
Caution
+
Data import can be a demanding process for your server. Hence, it is done in two steps:
+
+
Insertion of the URL in the wallabag database
+
in the second step, the retrieval, for each article, of its full content.
+
+
These two steps cannot be done concurrently, because it let us the possibility to import thousands of links, but today, wallabag does not have sufficient technical capabilities to do this task automatically.
+
From Pocket
+
Export your data from Pocket
+
From your Pocket account, go to the options.
+TODO
+
Import your Pocket data
+
From the configuration page of wallabag, section Import, select the file ril_export.html generated by Pocket, then click on Import.
+Wallabag only insert these links in the database. Now, you have to get the content of each article.
+
For this, click on Click to finish import: wallabag will fetch the content of 10 articles at a time.
+
TODO
+
TODO new ticket: why when a click is done, this does not load in a loop? I believe this was doing this ping @mariroz
+
From Instapaper
+
Export your data from Instapaper
+
TODO
+
Import your Instapaper data
+
TODO
+
From Readability
+
Export your data from Readability
+
TODO
+
Import your Readability data
+
TODO
+
From wallabag
+
Since you can export your data from wallabag (see below), it is of course possible to re-import them.
+
In the import form, select your wallabag-exported file (format JSON). Start the import, et voilà.
+
Unlike the above imports, this process is shorter because all the data (title and content of the articles) are already included in the file. Hence wallabag does not have to access each URL. However, the import file is necessarily bigger.
+
From a HTML or JSON file
+
TODO
+
Export
+
It is possible to export your data from the page Configuration of wallabag. Several reasons to do this:
+
+
re-install of wallabag
+
leave the Framabag service to install your own wallabag
+
a user with an account on a multi-user wallabag want to have his/her own wallabag installation
+
...
+
+
This will lead you to download a file at the JSON format.
+As detailed above, you can import this file in wallabag.
To be able to find more easily your articles, several methods are available.
+
Tags
+
Assign a tag
+
When saving an article
+
To tag an article when saving it, just click on the tag icon next to the URL field before hitting the Save button. At the moment, it is possible only to do this from the web interface, but it could come to some apps or extensions.
+
From the article
+
To tag an already-saved article, go to the reading page of the article. There is a part tags followed with a pencil. Click on the pencil.
+
Input in the box the tags you want to assign. Add as many tags as you want. They need to be separated by commas and not spaces. Auto-completion is available here: when you type the first letters of an existing tag, it is not necessary to type the whole word. Select it in the drop-down list. Once all your tags are inputted, click on the button Tag.
+
Then, you can go back to your article and read it.
+
From the search
+
A full chapter on search is available. Here, we will describe only how to assign a tag from your search.
+
When your search displays results, there is a link Apply the tag ABCD to this search at the bottom of the page. Click on it: a tad depending on your search (here ABCD) will be assigned to all the articles found.
+
Find all the articles with a given tag
+
In the wallabag menu, click on Tags. Then, all the tags you have created are displayed, sorted by the number of articles for each tag. Click on one of these tags to find all the articles with this tag.
+
Preferred articles
+
When you wish to set aside an article, you can mark it as preferred.
+
Set an article as favorite
+
From the reading page of an article, or from a list of articles (such as the list of unread articles), you can set an article as favorite simply by a click on the star which is displayed.
+Click again on the star will remove the favorite status of this article.
+
Find all the favorite articles
+
In the wallabag menu, click on Favorites to display the list of all the articles that you have set as favorite.
+
Archived articles
+
When you have read an article, you can archive it: hence it will not be displayed in your list of unread articles.
+
Archiving an article does not remove it from wallabag.
+
Archive an article
+
From the reading page of an article, or from a list of articles (such as the list of unread articles), you can archive an article simply by clicking on the icon ✓.
+Click again on this icon will set back the unread status of the article.
+
Find all the archived articles
+
In the wallabag menu, click on Archive to find all the articles that you have archived.
+
Delete an article
+
Be cautious: the deletion of an article is definitive. It is deleted from the wallabag database.
+
To delete an article, a trash icon is displayed on the page of an article or of a list of articles (unread articles, favorites or archived, for example).
+
We trust you: that is why there is no confirmation message during the deletion.
To read an article is not the most complex thing in wallabag: you only have to click on the title of the article for it to be displayed.
+
Back to where you quit reading your article
+
If you quit reading an article while you are only at half of it (for example), when you will open it again, wallabag will display it at the place you left the article.
+
This feature works only with web applications and not with smartphone applications.
+
Possible actions in an article
+
These actions are possible through the icons displayed at the top of the page. We suppose that you are using the theme Baggy (read the documentation about how to change theme). Icons in other themes are very similar.
+
Here are the actions, in the order of appearance of the icons.
+
Read the original article
+
Move to the original article.
+
Mark the article as read
+
Archive the article, that will be put in the category Archive of the wallabag menu.
+Clicking again on this button will move the article back to the unread category.
+
Mark the article as favorite
+
Mark the article as favorite, and it will be put to the category Favorites of the wallabag menu
+Clicking again on this button will remove the favorite status.
+
Delete the article
+
Delete completely the article from wallabag. It cannot be restored. Be careful: no confirmation message is displayed.
+
Share through twitter
+
Share the title and the original link of the article through twitter.
+
Share via email
+
Share the title and the original link of the article via email.
read your articles from your favorite RSS feed reader.
+
to activate the reading features for smartphone softwares
+
+
First, you must activate the RSS feature by generating a feed token.
+Go to config in wallabag and generate a token in the section Feeds.
+You can generate a new token at any time.
+
Read articles
+
Once the token created, you have access to three RSS feeds:
+
+
the one of the unread articles
+
the one of the favorites articles
+
the one of the archived articles
+
+
Add the feed you want to your RSS feed reader.
+Be careful: when you will be reading an article from your feed reader, this will not set it as read in wallabag.
+
Share your readings
+
If you wish to share your readings with somebody, send him for example the RSS feed of your favorite articles.
+Hence, as soon as an article will be set as favorite in wallabag, this person will be able to read it too.
+
Activate the features for smartphones
+
You ave created an RSS feed token. It will also be useful to you to configure your smartphone software. For more information about smartphone sofwares, you can read Save your first article.
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/en/User/save_your_first_article.html b/docs/en/User/save_your_first_article.html
new file mode 100644
index 000000000..37b4ce7c7
--- /dev/null
+++ b/docs/en/User/save_your_first_article.html
@@ -0,0 +1,250 @@
+
+
+
+
+
+
+ wallabag - Save your first article
+
+
+
+
+
+
+
+
+
+
+
+ wallabag
+
+ Save your first article
+
+
+ EN - FR - DE - RU
+
+
+
+
+
+
+
+
+
+
+
+
+
Save your first article
+
Once connected on wallabag, you have many ways to save an article.
+
From the web application
+
Let's see first how to do from the web application. In the menu, you have a link save a link. Clicking on it, a form shows up: you simply have to type the web adress of the article you want to save.
+
Confirm to store the content of the article.
+
By default, only the text is saved. If you want to store a copy of the images on your server, you have to enable the setting DOWNLOAD_PICTURES. Read the chapter on hidden options for more information.
A bookmarklet is a bookmark stored in a web browser that contains JavaScriptcommands to extend the browser's functionality.
+
Bookmarklets are unobtrusive scripts stored as the URL of a bookmark in a web browser or as a hyperlink on a web page.
+
When clicked, a bookmarklet performs some function, one of a wide variety such as a search query or data extraction. Bookmarklets are usually JavaScript programs.
+
+
From the wallabag's menu, click on settings. On the first part of this page, we have listed all the ways to save an article. You'll find the bookmarklet (it's the Bag it! link) to drag and drop in the bookmarks bar of your web browser.
+From now on, when you want to save the article you are browsing, you just have to click on this bookmarklet and the article will be automatically saved.
+
From your smartphone
+
Above all else
+
To use a smartphone application, you have to enable RSS feeds from the settings panel of wallabag. Then some information will be displayed, like your security tokken. Read the chapter on RSS feeds for more information.
+
Android
+
Installation and configuration
+
You can download the android application from the Google Play Store and from F-droid. It's the exact same application on those two stores.
+
Once installed, start the application, go to the settings part et fill in the URL (complete address of your wallabag installation or your Framabag account) and User ID (in most cases, you'll have to put 1) fields. If you have created multiple accounts from wallabag, you will have to to fill the user account you want to connect to your application and your security Token (enter properly all the token's letters as seen in the settings part of wallabag).
+
Saving of an article
+
Now that everything is correctly set up, as soon as you browse on your smartphone's web browser, you can share an article in wallabag at any time from the Share menu: you'll find a Bag it! entry which will add your article in wallabag.
+
Reading
+
When you open the application, click on Synchronize: your recently saved articles will be downloaded on your smartphone.
+
You don't need an internet connection anymore: click on List articles to start your reading.
+
At the end of each article, a Mark as read button allows you to archive the article.
+
To date, the synchronisation occurs in one direction (from wallabag to the application), thus preventing mark as read an article on wallabag from your smartphone.
+
iOS
+
Installation and configuration
+
You can download the iOS application from the AppStore.
+
Once installed, configure the app by filling following fields inside the settings: the URL (complete address of your wallabag installation or your Framabag account) and User ID (in most cases, you'll have to put 1) field. If you have created multiple accounts from wallabag, you will have to to fill the user account you want to connect to your application and your security Token (enter properly all the token's letters as seen in the settings part of wallabag).
+
Usage
+
If the app is configured correctly, the app will automatically download the articles from your wallabag (use pull-to-refresh to trigger this update manually). Once an article is downloaded, it'll be available offline from your app.
+
Unfortunately you can only locally mark an article as read (it will not synchronise to your online wallabag).
+
Saving articles
+
If you're browsing a website and want to add the current article to your wallabag, simply tap the Share-button and select Bag it! (if you don't find the wallabag icon, have a look in the more-menu). If everything is set up correctly, your article will be saved (you may have to login from time to time).
+
Windows Phone
+
Installation and configuration
+
You can download the Windows Phone application from the Windows Store or directly from your smartphone's Store.
+
Once installed, the application will show you a notification on the first launch, asking the configuration of your wallabag server. Go to the Settings part of the application by pressing the three dots menu at the bottom of the screen, then fill in the URL (complete address of your wallabag installation or your Framabag account) and User ID (in most cases, you'll have to put 1) fields.
+
If you have created multiple accounts from wallabag, you will have to to fill the user account you want to connect to your application and your security Token (enter properly all the token's letters as seen in the setting part of wallabag).
+
From your web browser
+
Firefox
+
Download the Firefox add-on on addons.mozilla.org and install it like any other Firefox add-on.
+
In the add-on's settings, fill the complete URL of your installation of wallabag or your Framabag account.
+
Personalize the Firefox toolbar to add wallabag (W icon). When you find an article you want to save, click on this icon: a new window will open to add the article and will close itself automatically.
+
Chrome
+
Download the Chrome add-on on the dedicated website and install it like any other Chrome add-on.
+
In the add-on's settings, fill the complete URL of your installation of wallabag or your Framabag account.
+
During the addon's installation, a new icon appear in Chrome toolbar (a W icon). When you find an article you want to save, click on this icon: a popup will appear to confirm that your article has been saved.
From the configuration menu, you can change some wallabag's options.
-
Some parts won't be presented here as they have a complete chapter in the documentation (RSS
-feeds, import from a third party service, export your data, Epub conversion and multi-user mode).
-
Theme
-
Of tastes and colors, we do not discuss. That's why wallabag offers you to change its skin to please everyone.
-
Select the theme of your choice from the drop down list and confirm by clicking on Update.
-
Language
-
Select the language of your choice in the drop down list and confirm by clicking on Update
-.
-
Password
-
Fill in your new password in the two dedicated fields and confirm by clicking on Update.
-
You will be disconnected and need to enter your new password to access your wallabag.
-
Clear the cache
-
The cache allows wallabag perform certain functions faster.
-
After updating wallabag, it is advised to clear the cache. You only have to click to do so.
If you can't or don't want to install Wallabag on your server, we suggest you create a free account on Framabag wich uses our software: read the complete documentation here (TODO write Create a framabag account).
To ensure that your server has all the prerequisites, you can run the file wallabag_compatibility_test.php that is located in the install directory of wallabag.
-
Installation of the dependencies
-
In order to work properly, wallabag needs some dependencies. To install them, you have to use composer. In your wallabag folder, run the following commands:
If you can't install composer (In order to work properly, Wallabag needs some dependencies), we provide you a vendor.zip file to unpack in your wallabag directory.
-
Permissions
-
Your web server needs a writing access in assets, cache and db directory. Otherwise, a message will report that the installation is impossible.
-
Installation of wallabag. At last.
-
Access to wallabag from your web browser. If your server is correctly configured, you reach the setup screen.
-
Fill your database type (sqlite, mysql or postgresql) and finally the information for your user account.
-
wallabag is now installed.
-
Login
-
From your web browser, you reach the login screen : fill your username and your password to connect to your account.
Attention, this part is for advanced users only. We'll edit an important file of wallabag, inc/poche/config.inc.php, please make a backup of this file before changes.
-If you make a mistake while editing a wallabag file, your application may be broken.
-
This file is created when wallabag is installed.
-Please first install wallabag, make a backup of this file and open it with Sublime Text your favorite editor.
-
In this file are defined some parameters that you can't change on the wallabag configuration page.
-
Advanced options
-
Each parameter is defined like this:
-
@define ('PARAMETER_NAME', 'Parameter value');
-
For each line, you can only change Parameter value part.
-
TODO explain all the following parameters
-
Here are all the parameters you can change:
-
-
HTTP_PORT (default value is 80): Expected value: a digit.
-
SSL_PORT (default value is 443): Expected value: a digit.
-
DEBUG_POCHE (default value is FALSE): Expected values: TRUE or FALSE.
-
DOWNLOAD_PICTURES (default value is FALSE): Expected values: TRUE or FALSE.
-
SHARE_TWITTER (default value is TRUE): Expected values: TRUE or FALSE.
-
SHARE_MAIL (par défaut, TRUE): Expected values: TRUE or FALSE.
-
SHARE_SHAARLI (default value is FALSE): Expected values: TRUE or FALSE.
-
SHAARLI_URL (default value is 'http://myshaarliurl.com'): Expected value: your Shaarli URL.
-
FLATTR (default value is TRUE): Expected values: TRUE or FALSE.
-
SHOW_PRINTLINK (default value is '1'): Expected values: '0' to disable, '1' to enable.
-
SHOW_READPERCENT (default value is '1'): '0' to disable, '1' to enable.
-
PAGINATION (default value is '12'): Expected value: a digit.
Once connected on wallabag, you have many ways to save an article.
-
From the web application
-
Let's see first how to do from the web application. In the menu, you have a link save a link. Clicking on it, a form shows up : you simply have to type the web adress of the article you want to save.
-
Confirm to store the content of the article.
-
By default, only the text is saved. If you want to store a copy of the images on your server, you have to enable the setting DOWNLOAD_PICTURES. Read the chapter on hidden options for more information.
A bookmarklet is a bookmark stored in a web browser that contains JavaScriptcommands to extend the browser's functionality.
-
Bookmarklets are unobtrusive scripts stored as the URL of a bookmark in a web browser or as a hyperlink on a web page.
-
When clicked, a bookmarklet performs some function, one of a wide variety such as a search query or data extraction. Bookmarklets are usually JavaScript programs.
-
-
From the wallabag's menu, click on settings. On the first part of this page, we have listed all the ways to save an article. You'll find the bookmarklet (it's the Bag it ! link) to drag and drop in the bookmarks bar of your web browser.
-From now on, when you want to save the article you are browsing, you just have to click on this bookmarklet and the article will be automatically saved.
-
From your smartphone
-
Above all else
-
To use a smartphone application, you have to enable RSS feeds from the settings panel of wallabag. Then some information will be displayed, like your security tokken. Read the chapter on RSS feeds for more information.
-
Android
-
Installation and configuration
-
You can download the android application from the Google Play Store and from F-droid. It's the exact same application on those two stores.
-
Once installed, start the application, go to the settings part et fill in the URL (complete address of your wallabag installation or your Framabag account) and User ID (in most cases, you'll have to put 1) fields. If you have created multiple accounts from wallabag, you will have to to fill the user account you want to connect to your application and your security Token (enter properly all the token's letters as seen in the settings part of wallabag).
-
Saving of an article
-
Now that everything is correctly set up, as soon as you browse on your smartphone's web browser, you can share an article in wallabag at any time from the Share menu : you'll find a Bag it ! entry which will add your article in wallabag.
-
Reading
-
When you open the application, click on Synchronize : your recently saved articles will be downloaded on your smartphone.
-
You don't need an internet connection anymore : click on List articles to start your reading.
-
At the end of each article, a Mark as read button allows you to archive the article.
-
To date, the synchronisation occurs in one direction (from wallabag to the application), thus preventing mark as read an article on wallabag from your smartphone.
-
iOS
-
Installation and configuration
-
TODO
-
Utilization
-
TODO
-
Windows Phone
-
Installation and configuration
-
You can download the Windows Phone application from the Windows Store or directly from your smartphone's Store.
-
Once installed, the application will show you a notification on the first launch, asking the configuration of your wallabag server. Go to the Settings part of the application by pressing the three dots menu at the bottom of the screen, then fill in the URL (complete address of your wallabag installation or your Framabag account) and User ID (in most cases, you'll have to put 1) fields.
-
If you have created multiple accounts from wallabag, you will have to to fill the user account you want to connect to your application and your security Token (enter properly all the token's letters as seen in the setting part of wallabag).
-
From your web browser
-
Firefox
-
Download the Firefox add-on on addons.mozilla.org and install it like any other Firefox add-on.
-
In the add-on's settings, fill the complete URL of your installation of wallabag or your Framabag account.
-
Personalize the Firefox toolbar to add wallabag (W icon). When you find an article you want to save, click on this icon : a new window will open to add the article and will close itself automatically.
-
Chrome
-
Download the Chrome add-on on the dedicated website and install it like any other Chrome add-on.
-
In the add-on's settings, fill the complete URL of your installation of wallabag or your Framabag account.
-
During the addon's installation, a new icon appear in Chrome toolbar (a W icon). When you find an article you want to save, click on this icon : a popup will appear to confirm that your article has been saved.
If you have a problem while installation or using wallabag (either with the web application or the smartphone applications), use the support site http://support.wallabag.org.
+
We will look if we can do to help you promptly, or if it is an new bug that we will need to correct.
+
It is better to use the support site than sending us an email: the followup is easier for us and the solution to your problem may help another user.
+
Create a new issue
+
If you find a bug during wallabag use, thanks for opening a new issue on Github (an account is required).
The documentation you are reading is likely to miss some points, to be out-of-date, to require a translation in your language. Hence, we invite you to take part in its writing.
Attention, cette partie concerne les utilisateurs avancés. Nous allons modifier un fichier important de wallabag, inc/poche/config.inc.php, il est donc conseillé de faire une sauvegarde de celui-ci avant toute modification.
+Toute erreur lors d'une modification d'un fichier de wallabag pourra entrainer des dysfonctionnements.
+
Ce fichier est créé lorsque vous installez wallabag.
+Installez donc d'abord wallabag, faites une copie du fichier et ouvrez-le avec Sublime Text votre éditeur de texte préféré.
+
Dans ce fichier sont définis des paramètres qui ne sont, aujourd'hui, pas encore disponibles dans la page Configuration de wallabag.
+
Modification des options avancées
+
Chaque paramètre est défini de cette façon :
+
@define ('NOM_DU_PARAMETRE', 'Valeur du paramètre');
+
Pour chaque ligne, vous ne pouvez modifier que la partie Valeur du paramètre.
+
Listons maintenant les différents paramètres que vous pouvez changer :
+
+
HTTP_PORT (par défaut, 80) : correspond au port HTTP de votre serveur web. À changer si votre serveur web est derrière un proxy. Valeur attendue : un nombre.
+
SSL_PORT (par défaut, 443) : correspond au port SSL de votre serveur web. À changer si votre serveur web utilises SSLH. Valeur attendue : un nombre.
+
DEBUG_POCHE (par défaut, FALSE) : si vous rencontrez des problèmes avec wallabag, nous vous demanderons peut-être d'activer le mode Debug. Valeurs attendues : TRUE ou FALSE.
+
DOWNLOAD_PICTURES (par défaut, FALSE) : permet de télécharger sur votre serveur les images des articles. Ce paramètre est désactivé par défaut pour ne pas surcharger votre serveur web. Nous préférons vous laisser activer vous-même ce paramètre. Valeurs attendues : TRUE ou FALSE.
+
SHARE_TWITTER (par défaut, TRUE) : permet d'activer le partage vers twitter. Valeurs attendues : TRUE ou FALSE.
+
SHARE_MAIL (par défaut, TRUE) : permet d'activer le partage par email. Valeurs attendues : TRUE ou FALSE.
+
SHARE_SHAARLI (par défaut, FALSE) : permet d'activer le partage vers votre installation de Shaarli (gestionnaire de favoris). Valeurs attendues : TRUE ou FALSE.
+
SHAARLI_URL (par défaut, 'http://myshaarliurl.com') : définit l'URL de votre installation de Shaarli. Valeur attendue : une URL.
+
FLATTR (par défaut, TRUE) : permet d'activer la possibilité de flattrer un article (Flattr est une plateforme de micro-dons). Si un article est flattrable, une icône s'affichera et vous permet d'envoyer un micro-don à l'auteur de l'article. Valeurs attendues : TRUE ou FALSE.
+
SHOW_PRINTLINK (par défaut, '1') : permet d'afficher le lien pour imprimer un article. Valeurs attendues : '0' pour désactiver ou '1' pour activer.
+
SHOW_READPERCENT (par défaut, '1') : permet d'afficher (sur les thèmes default, dark, dmagenta, solarized, solarized-dark) le pourcentage de lecture de l'article. Valeurs attendues : '0' pour désactiver ou '1' pour activer.
+
PAGINATION (par défaut, '12') : définit le nombre d'articles affichés sur une liste. Valeur attendue : un nombre.
Pour être sûr que votre serveur possède tous les pré-requis, vous pouvez exécuter le fichier wallabag_compatibility_test.php qui se trouve dans le répertoire install de wallabag : dans votre navigateur, accédez à http://votreserveur.com/wallabag/install/wallabag_compatibility_test.php et installez les composants requis. Par exemple pour Tidy sur Ubuntu/Debian :
+
sudo apt-get install php5-tidy
+sudo service apache2 reload
+
Installation des dépendances
+
Pour pouvoir fonctionner, wallabag a besoin de dépendances. Pour les installer, vous devez utiliser composer. Placez-vous dans votre dossier wallabag (toujours dans le cas d'Ubuntu/Debian : /var/www/html/wallabag/) et exécutez les commandes suivantes :
Si vous ne pouvez pas installer composer (dans le cas d'hébergement mutualisé par exemple), nous vous proposons un fichier vendor.zip. Vous pouvez soit le télécharger puis le décompresser dans votre répertoire wallabag, soit laisser le script d'installation le faire pour vous.
+
Création de la base de données MySQL
+
wallabag peut s'installer sur différents types de bases de données (sqlite, mysql ou postgresql), mais nous vous conseillons d'utiliser MySQL, plus performante. Il est alors nécessaire de créer une nouvelle base (par exemple wallabag), un nouvel utilisateur (par exemple wallabag) et un mot de passe (ici VotreMotdePasse). Vous pouvez pour cela utiliser 'phpMyAdmin', ou exécuter les commandes suivantes :
+
mysql -p -u root
+mysql> CREATE DATABASE wallabag;
+mysql> GRANT ALL PRIVILEGES ON `wallabag`.* TO 'wallabag'@'localhost' IDENTIFIED BY 'VotreMotdePasse';
+mysql> exit
+
Permissions
+
Le serveur web doit avoir accès en écriture aux répertoires assets, cache et db. Sans cela, un message vous indiquera que l'installation est impossible :
Accédez à wallabag depuis votre navigateur : http://votreserveur.com/wallabag. Si votre serveur est bien configuré, vous arrivez sur l'écran d'installation.
+
Renseignez le type de votre base de données (sqlite, mysql ou postgresql) et les informations de votre base de données. Dans le cas de la base MySQL créée plus haut, la configuration standard sera :
Si vous avez un problème lors de l'installation ou de l'utilisation de wallabag (que ça soit l'application web ou les applications pour smartphone), utilisez le site de support http://support.wallabag.org.
-
Nous verrons alors si nous pouvons vous dépanner rapidement ou alors s'il s'agit un nouveau bug qu'il nous faudra corriger.
-
Il est préférable d'utiliser le site de support plutôt que de nous envoyer un mail : le suivi est plus pratique pour vous comme pour nous et la résolution de votre problème pourra resservir pour un autre utilisateur.
-
Créer un nouveau ticket
-
Si vous avez trouvé un bug lors de votre utilisation de wallabag, merci d'ouvrir un nouveau ticket sur Github (un compte est nécessaire).
La documentation que vous êtes en train de lire n'est sûrement pas complète, à jour, traduite dans votre langue. C'est pourquoi nous vous invitons à participer à sa rédaction.
Astuce : si vous êtes en train de lire une page de la documentation et vous vous rendez compte d'une erreur ou d'un oubli, cliquez sur le lien Fix this page qui se trouve à côté du titre de la page. Vous serez alors redirigés vers la page sur Github, vous n'aurez plus qu'à proposer vos modifications.
-
Corriger les bugs, résoudre les problèmes : faire du support
-
Deux possibilités :
-
-
lorsqu'un utilisateur de wallabag pose une nouvelle question sur le site de support, en tant qu'utilisateur avancé de wallabag, vous pouvez lui répondre.
Rien de compliqué ici, parlez de wallabag autour de vous. Utilisez le mot-clé #wallabag sur tous vos réseaux sociaux préférés : twitter, Facebook, Diaspora*, Google+, etc.
-
D'ailleurs, voici la liste de nos comptes sur ces réseaux, si jamais vous voulez nous citer dans un de vos messages :
Si vous souhaitez contribuer au projet en proposant de nouvelles fonctionnalités ou en corrigeant des bugs, il faut suivre les recommandations que vous lirez ci-dessous concernant le dépôt Git disponible à cette adresse : https://github.com/wallabag/wallabag.
+
État des lieux
+
Pour la gestion des différentes versions de wallabag, nous utilisons Git.
+
Nous utilisons plusieurs branches pour le code source de l'application web de wallabag :
+
+
la branche master : c'est la branche stable, celle qui est téléchargée pour tous ceux qui souhaitent installer wallabag pour leur utilisation.
+
la branche dev : avant d'être sur la branche master, toutes les corrections de bugs et nouvelles fonctionnalités doivent passer par cette branche. Cette branche n'est pas conseillée pour une utilisation en production.
+
la branche v2-symfony : c'est la branche de la refonte de wallabag. Un chapitre complet lui est consacré.
+
+
Workflow
+
Toutes les consignes concernant le dépôt Git se trouve dans le fichier CONTRIBUTING.md de wallabag. Merci de le lire attentivement avant toute modification.
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/fr/Developpeur/ecrire_fichier_configuration.html b/docs/fr/Developpeur/ecrire_fichier_configuration.html
new file mode 100644
index 000000000..04ae0c9b4
--- /dev/null
+++ b/docs/fr/Developpeur/ecrire_fichier_configuration.html
@@ -0,0 +1,214 @@
+
+
+
+
+
+
+ wallabag - Écrire un fichier de configuration
+
+
+
+
+
+
+
+
+
+
+
+ wallabag
+
+ Écrire un fichier de configuration
+
+
+ EN - FR - DE - RU
+
+
+
+
+
+
+
+
+
+
+
+
+
Écrire un fichier de configuration
+
wallabag peut utiliser des fichiers de configuration spécifiques à un site pour lire les articles de ce site. Ces fichiers sont stockés dans le répertoire inc/3rdparty/site_config/standard.
+
Le format utilisé pour ces fichiers est XPath. Inspirez-vous des exemples dans le répertoire pour en créer de nouveaux.
+
Génération automatique de fichiers de configuration
+
@FiveFilters a créé un outil très utile pour créer des fichiers de configuration. Vous devez taper l'adresse d'un article qui vous intéresse. puis vous sélectionnez le contenu que vous souhaitez.
+
+
Vous devez confirmer cette zone en essayant avec d'autres articles.
+Quand vous avez trouvé la bonne zone, cliquez simplement sur Download Full-Text RSS site config (Téléchargez la configuration du site Full-Text RSS) pour télécharger le fichier à inclure dans le répertoire.
+
Génération manuelle de fichiers de configuration
+
Si l'outil de FiveFilters ne marche pas tel qu´attendu, regardez la source d'un article (Ctrl+U sur Firefox ou Chromium). Cherchez votre contenu parmi le code source et repérez l'attribut class ou id de la zone que vous souhaitez.
+
Une fois que vous avez obtenu l'attribut id ou class, vous pouvez écrire par exemple l'une ou l'autre de ces lignes :
Ensuite, testez votre fichier de configuration avec d'autres articles du même site. Si vous avez trouvé le bon contenu mais que vous voulez enlever des parties inutiles, ajoutez la ligne suivante (avec l'attribut class correspondant à la partie inutile) :
Vagrant est un logiciel libre et open-source pour la création et la configuration des environnements de développement virtuel. Il peut être considéré comme un wrapper autour du logiciel de virtualisation comme VirtualBox.
+
Utiliser Vagrant pour wallabag
+
Voici la procédure pour exécuter wallabag au sein d'un conteneur Vagrant :
+
wget -O wallabag-dev.zip https://github.com/wallabag/wallabag/archive/dev.zip
+unzip wallabag-dev.zip
+cd wallabag-dev
+vagrant up
+
Accédez maintenant à http://localhost:8003 et à vous de jouer !
Si vous souhaitez contribuer au projet en proposant de nouvelles fonctionnalités ou en corrigeant des bugs, il faut suivre les recommandations que vous lirez ci-dessous concernant le dépôt Git disponible à cette adresse : https://github.com/wallabag/wallabag.
-
État des lieux
-
Pour la gestion des différentes versions de wallabag, nous utilisons Git.
-
Nous utilisons plusieurs branches pour le code source de l'application web de wallabag :
-
-
la branche master : c'est la branche stable, celle qui est téléchargée pour tous ceux qui souhaitent installer wallabag pour leur utilisation.
-
la branche dev : avant d'être sur la branche master, toutes les corrections de bugs et nouvelles fonctionnalités doivent passer par cette branche. Cette branche n'est pas conseillée pour une utilisation en production.
-
la branche v2-symfony : c'est la branche de la refonte de wallabag. Un chapitre complet lui est consacré.
-
-
Workflow
-
Toutes les consignes concernant le dépôt Git se trouve dans le fichier CONTRIBUTING.md de wallabag. Merci de le lire attentivement avant toute modification.
Vagrant est un logiciel libre et open-source pour la création et la configuration des environnements de développement virtuel. Il peut être considéré comme un wrapper autour du logiciel de virtualisation comme VirtualBox.
-
Utiliser Vagrant pour wallabag
-
Voici la procédure pour exécuter wallabag au sein d'un conteneur Vagrant :
-
wget -O wallabag-dev.zip https://github.com/wallabag/wallabag/archive/dev.zip
-unzip wallabag-dev.zip
-cd wallabag-dev
-vagrant up
-
Accédez maintenant à http://localhost:8003 et à vous de jouer !
Pour pouvoir retrouver plus facilement vos articles, plusieurs méthodes existent.
-
Tags
-
Assigner un tag
-
Depuis l'article
-
Aujourd'hui, il n'est pas encore possible d'assigner un tag lorsque vous sauvegardez un nouvel article.
-
Tout ajout de tag se fera donc sur un article déjà sauvegardé.
-
Sur la page de lecture de l'article, se trouve une partie tags suivie d'un crayon. Cliquez sur ce crayon.
-
Saisissez dans la case les tags que vous souhaitez assigner. Saisissez autant de tgas que vous le voulez, vous pouvez les séparer par une virgule pour gagner du temps. L'auto-complétion existe ici : si vous tapez les premières lettres d'un tag déjà existant, inutile de taper le mot en entier, sélectionnez-le dans la liste déroulante. Une fois tous vos tags saisis, cliquez sur le bouton Tag.
-
Vous pouvez ensuite retourner lire votre article.
-
Depuis la recherche
-
Un chapitre complet sur la recherche existe. Ici, nous verrons uniquement comment assigner un tag depuis votre recherche.
-
Lorsque votre recherche vous affiche les résultats, vous avez un lien en bas de page Apply the tag ABCD to this search. Cliquez dessus : un tag en fonction de la recherche que vous venez d'effectuer (ici ABCD) sera assigné à tous les articles trouvés.
-
Retrouver tous les articles d'un même tag
-
Dans le menu de wallabag, cliquez sur Tags. Ici s'affichent tous les tags que vous avez créés, triés par nombre d'articles au sein de chaque tag. Cliquez sur l'un de ces tags pour retrouver tous les articles correspondants à ce tag.
-
Articles favoris
-
Lorsque vous souhaitez mettre de côté un article, vous pouvez le marquer comme favori.
-
Marquer un article comme favori
-
Depuis la page de lecture d'un article, ou depuis une liste d'articles (par exemple, la liste des articles non lus), vous pouvez mettre un article comme favori juste en cliquant sur l'étoile qui apparait.
-Recliquer sur cette étoile enlèvera le statut favori de cet article.
-
Retrouver tous ses articles favoris
-
Dans le menu de wallabag, cliquez sur Favoris pour retrouver tous les articles que vous avez déjà mis en favori.
-
Articles archivés
-
Lorsque vous avez lu un article, vous pouvez l'archiver : ainsi il n'apparaitra plus dans votre liste d'articles non lus.
-Le fait d'archiver un article ne le supprime pas de wallabag.
-
Archiver un article
-
Depuis la page de lecture d'un article, ou depuis une liste d'articles (par exemple, la liste des articles non lus), vous pouvez archiver un article juste en cliquant sur l'icône ✓.
-Recliquer sur cette icône remettra l'article en statut non lu.
-
Retrouver tous ses articles archivés
-
Dans le menu de wallabag, cliquez sur Archive pour retrouver tous les articles que vous avez déjà archivés.
-
Supprimer l'article
-
Attention, la suppression d'un article est définitive : il est supprimé de la base de données de wallabag.
-
Pour supprimer un article, une icône de corbeille se trouve sur la page d'un article ou sur une liste d'articles (articles non lus, favoris ou archivés par exemple).
-
Nous vous faisons confiance : c'est pourquoi il n'y a aucune demande de confirmation lors de la suppression.
Des goûts et des couleurs, on ne discute pas. C'est pourquoi wallabag vous propose de changer son habillage pour plaire à chacun.
-Sélectionnez le thème de votre choix dans la liste déroulante et validez en cliquant sur Mettre à jour.
-
Langue
-
Sélectionnez la langue de votre choix dans la liste déroulante et validez en cliquant sur Mettre à jour.
-
Mot de passe
-
Saisissez votre nouveau mot de passe dans les deux champs prévus et validez en cliquant sur Mettre à jour.
-Vous serez alors déconnecté et devrez saisir votre nouveau mot de passe pour accéder à wallabag.
-
Vider le cache
-
Le cache permet à wallabag d'effectuer certains traitements plus rapidement.
-Après une mise à jour de wallabag, il est conseillé de vider le cache. Vous n'avez qu'un clic à faire pour le vider.
Pour que vous puissiez lire vos articles sauvegardés depuis votre liseuse, wallabag vous permet de les convertir au format ePub et ainsi vous créer un eBook pour vos longues soirées d'hiver.
-
Mise en garde
-
Attention, la génération de fichiers ePub peut être très consommatrice de ressources pour le serveur sur lequel est installé wallabag. Cela dépend du nombre d'articles et de leur longueur.
-Ne générez pas un eBook trop important si cela n'est pas nécessaire.
-
Où convertir les articles
-
Vous pouvez convertir vos articles depuis différents endroits de wallabag :
-
-
sur la page de lecture d'un article : le lien ePub convertira ce seul article
-
depuis une liste d'articles (articles non lus, favoris ou archivés, articles d'un tag) : un lien en bas de page vous permet de convertir tous les articles de cette catégorie
-
depuis une recherche : le lien se trouve en bas de page
-
depuis la page de configuration : vous allez pouvoir convertir tous vos articles, peu importe la catégorie dans laquelle ils se trouvent
de lire vos articles depuis votre lecteur de flux RSS préféré
-
d'activer les fonctionnalités de lecture pour les applications smartphones
-
-
Tout d'abord, vous devez activer la fonctionnalité RSS en générant votre jeton de flux.
-Rendez-vous dans configuration de wallabag et créez le jeton dans la partie Flux.
-À tout moment, vous pouvez générer un nouveau jeton.
-
Lire les articles
-
Une fois le jeton créé, vous avez accès à trois flux RSS :
-
-
celui des articles non lus
-
celui des articles favoris
-
celui des articles archivés
-
-
Ajoutez le flux de votre choix dans votre lecteur de flux RSS.
-Attention, lorsque vous lirez un article depuis votre lecteur de flux, ça ne le marquera pas comme lu dans wallabag.
-
Partager vos lectures
-
Si vous souhaitez partager vos lectures avec quelqu'un, envoyez-lui par exemple le flux RSS de vos articles préférés. Ainsi, dès qu'un article sera mis en favori dans wallabag, cette personne pourra également le lire.
-
Activer les fonctionnalités pour smartphones
-
Vous avez créé le jeton de flux RSS : il va vous être utile pour configurer votre application smartphone. Pour en savoir sur les applications smartphones, vous pouvez lire Sauvegarder son premier article.
Pour importer des données dans wallabag, vous devez vous rendre dans la page Configuration.
-
Mise en garde
-
L'import de données peut être une opération gourmande pour votre serveur. C'est pourquoi elle s'effectue en deux étapes :
-
-
l'insertion des URL dans la base de données de wallabag
-
dans un second temps, la récupération, pour chaque article, du contenu complet
-
-
Ces deux actions ne peuvent pas être effectuées simultanément, car nous vous donnons la possibilité d'importer des milliers de liens, mais aujourd'hui, wallabag n'a pas les possibilités techniques nécessaires pour effectuer tout ce travail automatiquement.
-
Depuis Pocket
-
Exporter ses données depuis Pocket
-
Depuis votre compte Pocket, rendez-vous dans vos options.
-TODO
-
Importer ses données Pocket
-
TODO
-
Depuis Instapaper
-
Exporter ses données depuis Instapaper
-
TODO
-
Importer ses données Instapaper
-
TODO
-
Depuis Readability
-
Exporter ses données depuis Readability
-
TODO
-
Importer ses données Readability
-
TODO
-
Depuis wallabag
-
Puisque vous pouvez exporter vos données de wallabag (lire ci-dessous), il est évidemment possible de les réimporter.
-
Dans le formulaire d'import, sélectionnez votre fichier d'export wallabag (au format JSON). Démarrez l'import et voila.
-
Contrairement aux imports ci-dessus, le traitement est moins long car toutes les données (titre et contenu des articles) sont déjà présentes dans le fichier, il n'est pas nécessaire pour wallabag d'accéder à chacune des URL.
-Par contre, le fichier d'import est forcément plus conséquent.
-
Depuis un fichier HTML ou JSON
-
TODO
-
Exporter
-
Il est possible d'exporter ses données depuis la page Configuration de wallabag. Plusieurs raisons possibles :
-
-
réinstaller wallabag
-
quitter le service Framabag pour installer soi-même wallabag
-
un compte sur un wallabag multi-utilisateurs souhaite avoir sa propre installation de wallabag
-
...
-
-
Vous téléchargerez alors un fichier au format JSON.
-Comme nous l'avons vu ci-dessus, il est possible d'importer ce fichier dans wallabag.
Attention, cette partie concerne les utilisateurs avancés. Nous allons modifier un fichier important de wallabag, inc/poche/config.inc.php, il est donc conseillé de faire une sauvegarde de celui-ci avant toute modification.
-Toute erreur lors d'une modification d'un fichier de wallabag pourra entrainer des dysfonctionnements.
-
Ce fichier est créé lorsque vous installez wallabag.
-Installez donc d'abord wallabag, faites une copie du fichier et ouvrez-le avec Sublime Text votre éditeur de texte préféré.
-
Dans ce fichier sont définis des paramètres qui ne sont, aujourd'hui, pas encore disponibles dans la page Configuration de wallabag.
-
Modification des options avancées
-
Chaque paramètre est défini de cette façon :
-
@define ('NOM_DU_PARAMETRE', 'Valeur du paramètre');
-
Pour chaque ligne, vous ne pouvez modifier que la partie Valeur du paramètre.
-
Listons maintenant les différents paramètres que vous pouvez changer :
-
-
HTTP_PORT (par défaut, 80) : correspond au port HTTP de votre serveur web. À changer si votre serveur web est derrière un proxy. Valeur attendue : un nombre.
-
SSL_PORT (par défaut, 443) : correspond au port SSL de votre serveur web. À changer si votre serveur web utilises SSLH. Valeur attendue : un nombre.
-
DEBUG_POCHE (par défaut, FALSE) : si vous rencontrez des problèmes avec wallabag, nous vous demanderons peut-être d'activer le mode Debug. Valeurs attendues : TRUE ou FALSE.
-
DOWNLOAD_PICTURES (par défaut, FALSE) : permet de télécharger sur votre serveur les images des articles. Ce paramètre est désactivé par défaut pour ne pas surcharger votre serveur web. Nous préférons vous laisser activer vous-même ce paramètre. Valeurs attendues : TRUE ou FALSE.
-
SHARE_TWITTER (par défaut, TRUE) : permet d'activer le partage vers twitter. Valeurs attendues : TRUE ou FALSE.
-
SHARE_MAIL (par défaut, TRUE) : permet d'activer le partage par email. Valeurs attendues : TRUE ou FALSE.
-
SHARE_SHAARLI (par défaut, FALSE) : permet d'activer le partage vers votre installation de Shaarli (gestionnaire de favoris). Valeurs attendues : TRUE ou FALSE.
-
SHAARLI_URL (par défaut, 'http://myshaarliurl.com') : définit l'URL de votre installation de Shaarli. Valeur attendue : une URL.
-
FLATTR (par défaut, TRUE) : permet d'activer la possibilité de flattrer un article (Flattr est une plateforme de micro-dons). Si un article est flattrable, une icône s'affichera et vous permet d'envoyer un micro-don à l'auteur de l'article. Valeurs attendues : TRUE ou FALSE.
-
SHOW_PRINTLINK (par défaut, '1') : permet d'afficher le lien pour imprimer un article. Valeurs attendues : '0' pour désactiver ou '1' pour activer.
-
SHOW_READPERCENT (par défaut, '1') : permet d'afficher (sur les thèmes default, dark, dmagenta, solarized, solarized-dark) le pourcentage de lecture de l'article. Valeurs attendues : '0' pour désactiver ou '1' pour activer.
-
PAGINATION (par défaut, '12') : définit le nombre d'articles affichés sur une liste. Valeur attendue : un nombre.
Lire un article n'est pas la chose la plus compliquée dans wallabag. Vous n'avez qu'à cliquer sur le titre d'un article pour l'afficher.
-
Revenir là où vous avez laissé votre article
-
Si vous quittez un article alors que vous n'êtes qu'à la moitié de celui-ci par exemple, lorsque vous reviendrez, wallabag vous renverra là où vous avez laissé l'article.
-
Cette astuce ne fonctionne qu'avec l'application web et pas les applications smartphones.
-
Actions possibles depuis l'article
-
Ces actions sont possibles grâce aux icônes affichés en haut de la page. Nous partons du principe que vous utilisez le thème Baggy (lire la documentation pour changer de thème), les icônes dans les autres thèmes sont sensiblement les mêmes.
-Voici donc ces actions, par ordre d'apparition des icônes.
-
Lire l'article original
-
Renvoie vers l'article original.
-
Marquer l'article comme lu
-
Archive l'article, qui se retrouvera dans la catégorie Archive du menu de wallabag.
-Recliquer dessus permet de replacer cet article en état non lu.
-
Mettre l'article en favori
-
Marque l'article comme favori, qui se retrouvera dans la catégorie Favoris du menu de wallabag.
-Recliquer dessus permet d'enlever le statut de favori.
-
Supprimer l'article
-
Supprime complètement l'article de wallabag. Il ne pourra être restauré. Attention, aucune confirmation n'est demandée.
-
Partager vers twitter
-
Partage le titre et le lien original de l'article sur twitter.
-
Partager par email
-
Partage le titre et le lien original de l'article par email.
Une fois connecté sur wallabag, vous avez plusieurs moyens pour sauvegarder un article.
-
Depuis l'application web
-
Voyons d'abord comment faire depuis l'application web. Dans le menu, vous avez un lien Sauvegarder un lien. En cliquant dessus, un formulaire s'affiche : vous n'avez qu'à saisir l'adresse internet de l'article concerné.
-
Validez et le contenu de l'article est enregistré.
-
Par défaut, seul le texte est sauvegardé. Si vous souhaitez également conserver une copie des images sur votre serveur, il faut activer le paramètre DOWNLOAD_PICTURES. Lisez le chapitre Les options cachées pour en savoir plus.
Un bookmarklet est un petit programme JavaScript pouvant être stocké :
-* soit en tant qu'URL dans un signet (marque-page ou lien favori) avec la plupart des navigateurs Web ;
-* soit en tant qu'hyperlien dans une page web.
-
Depuis le menu de wallabag, cliquez sur configuration. Dans la première partie de cette page, nous avons listé les différents moyens de sauvegarder un article. Vous trouverez ainsi le bookmarklet (c'est le lien bag it !) à glisser / déposer dans la barre de favoris de votre navigateur.
-
Dorénavant, lorsque vous souhaitez sauvegarder un article sur lequel vous êtes en train de surfer, vous n'avez qu'à cliquer sur ce bookmarklet et l'article sera automatiquement enregistré.
-
Depuis son smartphone
-
Avant toute chose
-
Pour pouvoir utiliser une application smartphone, vous devez activer les flux RSS depuis la partie configuration de wallabag. Certaines informations seront ainsi affichées, comme votre token (jeton de sécurité). Lisez le chapitre Flux RSS pour en savoir plus.
-
Android
-
Installation et configuration
-
Vous pouvez télécharger l'application Android depuis le Google Play Store et depuis F-droid. C'est exactement la même application sur ces deux plateformes de téléchargement.
-
Une fois installée, démarrez l'application, rendez-vous dans la partie settings et renseignez les champs URL (Adresse complète de votre installation de wallabag ou de votre compte Framabag), User ID (très souvent, il vous faudra mettre 1 comme valeur). Si vous avez créé plusieurs comptes depuis wallabag, il faudra saisir l'identifiant du compte que vous souhaitez connecter à votre application) et Token (recopiez bien tous les caractères du token, disponible dans la configuration de wallabag).
-
Sauvegarde d'un article
-
Maintenant que tout est bien configuré, dès que vous naviguerez avec le navigateur de votre smartphone, vous pourrez à tout moment partager un article dans wallabag depuis le menu Partager : vous trouverez une entrée Bag it! qui ajoutera l'article dans wallabag.
-
Lecture
-
Lorsque vous ouvrez l'application, cliquez sur Synchronize : vos articles dernièrement sauvegardés seront ainsi téléchargés sur votre smartphone.
-
Vous n'avez maintenant plus besoin de connexion internet : cliquez sur le bouton List articles pour commencer votre lecture.
-
En bas de chaque article, un bouton Mark as read vous permet d'archiver l'article.
-
Aujourd'hui, la synchronisation ne s'effectue que dans un sens (de wallabag vers l'application), ce qui empêche de marquer comme lu un article sur wallabag depuis votre smartphone.
-
iOS
-
Installation et configuration
-
TODO
-
Utilisation
-
TODO
-
Windows Phone
-
Installation et configuration
-
Vous pouvez télécharger l'application Windows Phone depuis le Windows Store ou directement dans le Store de votre smartphone.
-
Une fois installée, l'application affichera une notification au premier lancement, demandant la configuration du serveur wallabag. Rendez-vous dans la partie Configuration de l'application en appuyant sur les 3 petits points du menu en bas de l'écran, puis renseignez les champs URL (Adresse complète de votre installation de wallabag ou de votre compte Framabag), User ID (très souvent, il vous faudra mettre 1 comme valeur).
-Si vous avez créé plusieurs comptes depuis wallabag, il faudra saisir l'identifiant du compte que vous souhaitez connecter à votre application) et Token (recopiez bien tous les caractères du token, disponible dans la configuration de wallabag).
-Enfin, sauvegardez les paramètres entrés.
Dans les préférences de l'extension, renseignez l'URL complète de votre installation de wallabag ou de votre compte Framabag.
-
Personnalisez la barre d'outils de Firefox pour ajouter wallabag (icône w). Lorsque vous vous trouvez sur un article que vous souhaitez sauvegarder, cliquez sur cette icône : une nouvelle fenêtre s'ouvrira pour ajouter l'article et elle se refermera automatiquement.
-
Chrome
-
Téléchargez l'extension Chrome sur le site dédié et installez-la comme toute autre extension Chrome.
-
Dans les options de l'extension, renseignez l'URL complète de votre installation de wallabag ou de votre compte Framabag.
-
Lors de l'installation de l'extension, une nouvelle icône est apparue dans la barre d'outils de Chrome, une icône w. Lorsque vous vous trouvez sur un article que vous souhaitez sauvegarder, cliquez sur cette icône : une popup s'ouvrira et vous confirmera que l'article a bien été sauvegardé.
Puisque vous ne souhaitez peut-être pas gérer l'installation et la mise à jour de wallabag, ou puisque vous n'avez peut-être pas les connaissances pour l'installer, il vous est possible de vous créer un compte gratuit sur Framabag.org.
-
Création du compte
-
Cliquez sur le bouton Créez votre compte / Create your account.
-
Vous devez saisir certaines informations : votre nom d'utilisateur, votre mot de passe et votre adresse email. Votre adresse n'est utilisée que pour la validation de votre compte, sauf si vous cochez la case pour recevoir la newsletter (3 à 4 envois par an).
-
Une fois ce formulaire validé, vous recevez un email avec un lien de confirmation. Cliquez dessus, votre compte sera alors créé.
-
Vous recevrez un dernier email avec l'adresse de votre compte Framabag, de la forme https://www.framabag.org/u/votre-nom-d'utilisateur.
-
Stockage de vos informations
-
Framabag utilise une base de données par utilisateur. Nous ne faisons et ne ferons aucune utilisation de vos données stockées.
-
Vous avez oublié votre mot de passe
-
Si vous avez oublié votre mot de passe pour vous connecter à Framabag, un formulaire est disponible depuis la page d'accueil du service.
-Remplissez-le, un email de confirmation vous sera envoyé et vous permettra de saisir votre nouveau mot de passe.
-
Suppression de votre compte
-
Si vous souhaitez supprimer votre compte, contactez-nous par email : hello@wallabag.org avec l'adresse de création de votre compte, en nous indiquant votre nom d'utilisateur.
-
Nous vous répondrons quand votre compte sera supprimé : dès cet instant, plus aucune information vous concernant ne sera stockée sur Framabag.
Pour être sûr que votre serveur possède tous les pré-requis, vous pouvez exécuter le fichier wallabag_compatibility_test.php qui se trouve dans le répertoire install de wallabag.
-
Installation des dépendances
-
Pour pouvoir fonctionner, wallabag a besoin de dépendances. Pour les installer, vous devez utiliser composer. Dans votre dossier wallabag, exécutez les deux commandes suivantes :
Si vous ne pouvez pas installer composer (dans le cas d'hébergement mutualisé par exemple), nous vous proposons un fichier vendor.zip à décompresser dans votre répertoire wallabag.
-
Permissions
-
Le serveur web doit avoir accès en écriture aux répertoires assets, cache et db. Sans cela, un message vous indiquera que l'installation est impossible.
-
Installation de wallabag. Enfin.
-
Accédez à wallabag depuis votre navigateur. Si votre serveur est bien configuré, vous arrivez sur l'écran d'installation.
-
Renseignez le type de votre base de données (sqlite, mysql ou postgresql), les informations de votre base de données et enfin les informations pour votre compte utilisateur.
-
wallabag est maintenant installé.
-
Connexion
-
Vous arrivez sur l'écran d'identification : saisissez votre identifiant et votre mot de passe et vous voici connecté.
Si vous pensez que wallabag récupère mal le contenu d'un article (texte absent ou incomplet), nous vous proposons plusieurs possibilités.
-
Demande d'aide
-
Que ça soit par mail ou via un ticket, n'oubliez pas de nous donner certaines informations qui sont importantes pour que nous puissions résoudre le problème au mieux :
-
-
l'URL de l'article concerné
-
ce que wallabag affiche
-
ce à quoi vous vous attendiez
-
la version de wallabag ou alors si vous utilisez Framabag
-
-
Ouvrir un ticket sur github
-
Pour ouvrir un nouveau ticket, il faut aller sur github. Un compte est nécessaire.
-N'oubliez pas de nous envoyer les informations ci-dessus.
-
Nous envoyer un email
-
Envoyez-nous un lien avec comme sujet Wrong display in wallabag à l'adresse hello@wallabag.org.
-N'oubliez pas de nous envoyer les informations ci-dessus.
wallabag est une application de lecture différée : elle permet simplement d'archiver une page web en ne conservant que le contenu. Les éléments superflus (menu, publicité, etc.) sont supprimés.
-
Fonctionnalités
-
-
tout le contenu est archivé : le texte et les photos
Pour pouvoir retrouver plus facilement vos articles, plusieurs méthodes existent.
+
Tags
+
Assigner un tag
+
Depuis l'article
+
Aujourd'hui, il n'est pas encore possible d'assigner un tag lorsque vous sauvegardez un nouvel article.
+
Tout ajout de tag se fera donc sur un article déjà sauvegardé.
+
Sur la page de lecture de l'article, se trouve une partie tags suivie d'un crayon. Cliquez sur ce crayon.
+
Saisissez dans la case les tags que vous souhaitez assigner. Saisissez autant de tags que vous le voulez. Ils doivent être séparés par des virgules et non par des espaces. L'auto-complétion existe ici : si vous tapez les premières lettres d'un tag déjà existant, inutile de taper le mot en entier, sélectionnez-le dans la liste déroulante. Une fois tous vos tags saisis, cliquez sur le bouton Tag.
+
Vous pouvez ensuite retourner lire votre article.
+
Depuis la recherche
+
Un chapitre complet sur la recherche existe. Ici, nous verrons uniquement comment assigner un tag depuis votre recherche.
+
Lorsque votre recherche vous affiche les résultats, vous avez un lien en bas de page Apply the tag ABCD to this search. Cliquez dessus : un tag en fonction de la recherche que vous venez d'effectuer (ici ABCD) sera assigné à tous les articles trouvés.
+
Retrouver tous les articles d'un même tag
+
Dans le menu de wallabag, cliquez sur Tags. Ici s'affichent tous les tags que vous avez créés, triés par nombre d'articles au sein de chaque tag. Cliquez sur l'un de ces tags pour retrouver tous les articles correspondants à ce tag.
+
Articles favoris
+
Lorsque vous souhaitez mettre de côté un article, vous pouvez le marquer comme favori.
+
Marquer un article comme favori
+
Depuis la page de lecture d'un article, ou depuis une liste d'articles (par exemple, la liste des articles non lus), vous pouvez mettre un article comme favori juste en cliquant sur l'étoile qui apparait.
+Recliquer sur cette étoile enlèvera le statut favori de cet article.
+
Retrouver tous ses articles favoris
+
Dans le menu de wallabag, cliquez sur Favoris pour retrouver tous les articles que vous avez déjà mis en favori.
+
Articles archivés
+
Lorsque vous avez lu un article, vous pouvez l'archiver : ainsi il n'apparaitra plus dans votre liste d'articles non lus.
+Le fait d'archiver un article ne le supprime pas de wallabag.
+
Archiver un article
+
Depuis la page de lecture d'un article, ou depuis une liste d'articles (par exemple, la liste des articles non lus), vous pouvez archiver un article juste en cliquant sur l'icône ✓.
+Recliquer sur cette icône remettra l'article en statut non lu.
+
Retrouver tous ses articles archivés
+
Dans le menu de wallabag, cliquez sur Archive pour retrouver tous les articles que vous avez déjà archivés.
+
Supprimer l'article
+
Attention, la suppression d'un article est définitive : il est supprimé de la base de données de wallabag.
+
Pour supprimer un article, une icône de corbeille se trouve sur la page d'un article ou sur une liste d'articles (articles non lus, favoris ou archivés par exemple).
+
Nous vous faisons confiance : c'est pourquoi il n'y a aucune demande de confirmation lors de la suppression.
Des goûts et des couleurs, on ne discute pas. C'est pourquoi wallabag vous propose de changer son habillage pour plaire à chacun.
+Sélectionnez le thème de votre choix dans la liste déroulante et validez en cliquant sur Mettre à jour.
+
Langue
+
Sélectionnez la langue de votre choix dans la liste déroulante et validez en cliquant sur Mettre à jour.
+
Mot de passe
+
Saisissez votre nouveau mot de passe dans les deux champs prévus et validez en cliquant sur Mettre à jour.
+Vous serez alors déconnecté et devrez saisir votre nouveau mot de passe pour accéder à wallabag.
+
Vider le cache
+
Le cache permet à wallabag d'effectuer certains traitements plus rapidement.
+Après une mise à jour de wallabag, il est conseillé de vider le cache. Vous n'avez qu'un clic à faire pour le vider.
Pour que vous puissiez lire vos articles sauvegardés depuis votre liseuse, wallabag vous permet de les convertir au format ePub et ainsi vous créer un eBook pour vos longues soirées d'hiver.
+
Mise en garde
+
Attention, la génération de fichiers ePub peut être très consommatrice de ressources pour le serveur sur lequel est installé wallabag. Cela dépend du nombre d'articles et de leur longueur.
+Ne générez pas un eBook trop important si cela n'est pas nécessaire.
+
Où convertir les articles
+
Vous pouvez convertir vos articles depuis différents endroits de wallabag :
+
+
sur la page de lecture d'un article : le lien ePub convertira ce seul article
+
depuis une liste d'articles (articles non lus, favoris ou archivés, articles d'un tag) : un lien en bas de page vous permet de convertir tous les articles de cette catégorie
+
depuis une recherche : le lien se trouve en bas de page
+
depuis la page de configuration : vous allez pouvoir convertir tous vos articles, peu importe la catégorie dans laquelle ils se trouvent
de lire vos articles depuis votre lecteur de flux RSS préféré
+
d'activer les fonctionnalités de lecture pour les applications smartphones
+
+
Tout d'abord, vous devez activer la fonctionnalité RSS en générant votre jeton de flux.
+Rendez-vous dans configuration de wallabag et créez le jeton dans la partie Flux.
+À tout moment, vous pouvez générer un nouveau jeton.
+
Lire les articles
+
Une fois le jeton créé, vous avez accès à trois flux RSS :
+
+
celui des articles non lus
+
celui des articles favoris
+
celui des articles archivés
+
+
Ajoutez le flux de votre choix dans votre lecteur de flux RSS.
+Attention, lorsque vous lirez un article depuis votre lecteur de flux, ça ne le marquera pas comme lu dans wallabag.
+
Partager vos lectures
+
Si vous souhaitez partager vos lectures avec quelqu'un, envoyez-lui par exemple le flux RSS de vos articles préférés. Ainsi, dès qu'un article sera mis en favori dans wallabag, cette personne pourra également le lire.
+
Activer les fonctionnalités pour smartphones
+
Vous avez créé le jeton de flux RSS : il va vous être utile pour configurer votre application smartphone. Pour en savoir sur les applications smartphones, vous pouvez lire Sauvegarder son premier article.
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/fr/Utilisateur/framabag.html b/docs/fr/Utilisateur/framabag.html
new file mode 100644
index 000000000..180e95ae8
--- /dev/null
+++ b/docs/fr/Utilisateur/framabag.html
@@ -0,0 +1,213 @@
+
+
+
+
+
+
+ wallabag - Se créer un compte sur Framabag
+
+
+
+
+
+
+
+
+
+
+
+ wallabag
+
+ Se créer un compte sur Framabag
+
+
+ EN - FR - DE - RU
+
+
+
+
+
+
+
+
+
+
+
+
+
Se créer un compte sur Framabag
+
Puisque vous ne souhaitez peut-être pas gérer l'installation et la mise à jour de wallabag, ou puisque vous n'avez peut-être pas les connaissances pour l'installer, il vous est possible de vous créer un compte gratuit sur Framabag.org.
+
Création du compte
+
Cliquez sur le bouton Créez votre compte / Create your account.
+
Vous devez saisir certaines informations : votre nom d'utilisateur, votre mot de passe et votre adresse email. Votre adresse n'est utilisée que pour la validation de votre compte, sauf si vous cochez la case pour recevoir la newsletter (3 à 4 envois par an).
+
Une fois ce formulaire validé, vous recevez un email avec un lien de confirmation. Cliquez dessus, votre compte sera alors créé.
+
Vous recevrez un dernier email avec l'adresse de votre compte Framabag, de la forme https://www.framabag.org/u/votre-nom-d'utilisateur.
+
Stockage de vos informations
+
Framabag utilise une base de données par utilisateur. Nous ne faisons et ne ferons aucune utilisation de vos données stockées.
+
Vous avez oublié votre mot de passe
+
Si vous avez oublié votre mot de passe pour vous connecter à Framabag, un formulaire est disponible depuis la page d'accueil du service.
+Remplissez-le, un email de confirmation vous sera envoyé et vous permettra de saisir votre nouveau mot de passe.
+
Suppression de votre compte
+
Si vous souhaitez supprimer votre compte, contactez-nous par email : hello@wallabag.org avec l'adresse de création de votre compte, en nous indiquant votre nom d'utilisateur.
+
Nous vous répondrons quand votre compte sera supprimé : dès cet instant, plus aucune information vous concernant ne sera stockée sur Framabag.
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/fr/Utilisateur/importer_exporter.html b/docs/fr/Utilisateur/importer_exporter.html
new file mode 100644
index 000000000..8d977213f
--- /dev/null
+++ b/docs/fr/Utilisateur/importer_exporter.html
@@ -0,0 +1,245 @@
+
+
+
+
+
+
+ wallabag - Importer ou exporter ses données
+
+
+
+
+
+
+
+
+
+
+
+ wallabag
+
+ Importer ou exporter ses données
+
+
+ EN - FR - DE - RU
+
+
+
+
+
+
+
+
+
+
+
+
+
Importer ou exporter ses données
+
Importer
+
Pour importer des données dans wallabag, vous devez vous rendre dans la page Configuration.
+
Mise en garde
+
L'import de données peut être une opération gourmande pour votre serveur. C'est pourquoi elle s'effectue en deux étapes :
+
+
l'insertion des URL dans la base de données de wallabag
+
dans un second temps, la récupération, pour chaque article, du contenu complet
+
+
Ces deux actions ne peuvent pas être effectuées simultanément, car nous vous donnons la possibilité d'importer des milliers de liens, mais aujourd'hui, wallabag n'a pas les possibilités techniques nécessaires pour effectuer tout ce travail automatiquement.
+
Depuis Pocket
+
Exporter ses données depuis Pocket
+
Depuis votre compte Pocket, rendez-vous dans vos options.
+TODO
+
Importer ses données Pocket
+
Depuis la page de configuration de wallabag, partie Import, sélectionnez le fichier ril_export.html que Pocket a généré puis cliquez sur Import.
+wallabag ne fait qu'insérer les liens dans sa base de données. Il faut maintenant lui faire récupérer le contenu de chaque article.
+
Pour cela, cliquez sur Click to finish import : wallabag récupèrera alors le contenu de 10 articles à la fois.
+
TODO
+
TODO nouveau ticket : pourquoi quand on clique une fois, ça ne charge pas en boucle ? Il me semblait que ça faisait ça ping @mariroz
+
Depuis Instapaper
+
Exporter ses données depuis Instapaper
+
TODO
+
Importer ses données Instapaper
+
TODO
+
Depuis Readability
+
Exporter ses données depuis Readability
+
TODO
+
Importer ses données Readability
+
TODO
+
Depuis wallabag
+
Puisque vous pouvez exporter vos données de wallabag (lire ci-dessous), il est évidemment possible de les réimporter.
+
Dans le formulaire d'import, sélectionnez votre fichier d'export wallabag (au format JSON). Démarrez l'import et voila.
+
Contrairement aux imports ci-dessus, le traitement est moins long car toutes les données (titre et contenu des articles) sont déjà présentes dans le fichier, il n'est pas nécessaire pour wallabag d'accéder à chacune des URL.
+Par contre, le fichier d'import est forcément plus conséquent.
+
Depuis un fichier HTML ou JSON
+
TODO
+
Exporter
+
Il est possible d'exporter ses données depuis la page Configuration de wallabag. Plusieurs raisons possibles :
+
+
réinstaller wallabag
+
quitter le service Framabag pour installer soi-même wallabag
+
un compte sur un wallabag multi-utilisateurs souhaite avoir sa propre installation de wallabag
+
...
+
+
Vous téléchargerez alors un fichier au format JSON.
+Comme nous l'avons vu ci-dessus, il est possible d'importer ce fichier dans wallabag.
Lire un article n'est pas la chose la plus compliquée dans wallabag. Vous n'avez qu'à cliquer sur le titre d'un article pour l'afficher.
+
Revenir là où vous avez laissé votre article
+
Si vous quittez un article alors que vous n'êtes qu'à la moitié de celui-ci par exemple, lorsque vous reviendrez, wallabag vous renverra là où vous avez laissé l'article.
+
Cette astuce ne fonctionne qu'avec l'application web et pas les applications smartphones.
+
Actions possibles depuis l'article
+
Ces actions sont possibles grâce aux icônes affichés en haut de la page. Nous partons du principe que vous utilisez le thème Baggy (lire la documentation pour changer de thème), les icônes dans les autres thèmes sont sensiblement les mêmes.
+Voici donc ces actions, par ordre d'apparition des icônes.
+
Lire l'article original
+
Renvoie vers l'article original.
+
Marquer l'article comme lu
+
Archive l'article, qui se retrouvera dans la catégorie Archive du menu de wallabag.
+Recliquer dessus permet de replacer cet article en état non lu.
+
Mettre l'article en favori
+
Marque l'article comme favori, qui se retrouvera dans la catégorie Favoris du menu de wallabag.
+Recliquer dessus permet d'enlever le statut de favori.
+
Supprimer l'article
+
Supprime complètement l'article de wallabag. Il ne pourra être restauré. Attention, aucune confirmation n'est demandée.
+
Partager vers twitter
+
Partage le titre et le lien original de l'article sur twitter.
+
Partager par email
+
Partage le titre et le lien original de l'article par email.
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/fr/Utilisateur/rechercher.html b/docs/fr/Utilisateur/rechercher.html
new file mode 100644
index 000000000..4c6bc9648
--- /dev/null
+++ b/docs/fr/Utilisateur/rechercher.html
@@ -0,0 +1,206 @@
+
+
+
+
+
+
+ wallabag - Rechercher du contenu dans wallabag
+
+
+
+
+
+
+
+
+
+
+
+ wallabag
+
+ Rechercher du contenu dans wallabag
+
+
+ EN - FR - DE - RU
+
+
+
+
+
+
+
+
+
+
+
+
+
Rechercher du contenu dans wallabag
+
Pour que vous puissiez retrouver un article au plus vite, nous avons mis en place un moteur de recherche complet.
+
Cliquez sur Rechercher dans le menu de wallabag. Là, saisissez un terme de recherche.
+
wallabag ira parcourir tous vos articles et affichera ceux qui contiennent le terme de recherche dans leur titre ou dans le contenu de l'article.
+
Convertir cette recherche au format ePub
+
Vous pouvez convertir les articles retournés au format ePub, pour les lire sur une liseuse par exemple. Lisez Convertir en ePub pour en savoir plus.
+
Assigner un tag aux résultats de cette recherche
+
Vous pouvez créer un tag en fonction du critère de recherche. Lisez Classer ses articles pour en savoir plus.
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/fr/Utilisateur/sauvegarder_son_premier_article.html b/docs/fr/Utilisateur/sauvegarder_son_premier_article.html
new file mode 100644
index 000000000..5dd5e3867
--- /dev/null
+++ b/docs/fr/Utilisateur/sauvegarder_son_premier_article.html
@@ -0,0 +1,245 @@
+
+
+
+
+
+
+ wallabag - Sauvegarder son premier article
+
+
+
+
+
+
+
+
+
+
+
+ wallabag
+
+ Sauvegarder son premier article
+
+
+ EN - FR - DE - RU
+
+
+
+
+
+
+
+
+
+
+
+
+
Sauvegarder son premier article
+
Une fois connecté sur wallabag, vous avez plusieurs moyens pour sauvegarder un article.
+
Depuis l'application web
+
Voyons d'abord comment faire depuis l'application web. Dans le menu, vous avez un lien Sauvegarder un lien. En cliquant dessus, un formulaire s'affiche : vous n'avez qu'à saisir l'adresse internet de l'article concerné.
+
Validez et le contenu de l'article est enregistré.
+
Par défaut, seul le texte est sauvegardé. Si vous souhaitez également conserver une copie des images sur votre serveur, il faut activer le paramètre DOWNLOAD_PICTURES. Lisez le chapitre Les options cachées pour en savoir plus.
Un bookmarklet est un petit programme JavaScript pouvant être stocké :
+* soit en tant qu'URL dans un signet (marque-page ou lien favori) avec la plupart des navigateurs Web ;
+* soit en tant qu'hyperlien dans une page web.
+
Depuis le menu de wallabag, cliquez sur configuration. Dans la première partie de cette page, nous avons listé les différents moyens de sauvegarder un article. Vous trouverez ainsi le bookmarklet (c'est le lien bag it !) à glisser / déposer dans la barre de favoris de votre navigateur.
+
Dorénavant, lorsque vous souhaitez sauvegarder un article sur lequel vous êtes en train de surfer, vous n'avez qu'à cliquer sur ce bookmarklet et l'article sera automatiquement enregistré.
+
Depuis son smartphone
+
Avant toute chose
+
Pour pouvoir utiliser une application smartphone, vous devez activer les flux RSS depuis la partie configuration de wallabag. Certaines informations seront ainsi affichées, comme votre token (jeton de sécurité). Lisez le chapitre Flux RSS pour en savoir plus.
+
Android
+
Installation et configuration
+
Vous pouvez télécharger l'application Android depuis le Google Play Store et depuis F-droid. C'est exactement la même application sur ces deux plateformes de téléchargement.
+
Une fois installée, démarrez l'application, rendez-vous dans la partie settings et renseignez les champs URL (Adresse complète de votre installation de wallabag ou de votre compte Framabag), User ID (très souvent, il vous faudra mettre 1 comme valeur). Si vous avez créé plusieurs comptes depuis wallabag, il faudra saisir l'identifiant du compte que vous souhaitez connecter à votre application) et Token (recopiez bien tous les caractères du token, disponible dans la configuration de wallabag).
+
Sauvegarde d'un article
+
Maintenant que tout est bien configuré, dès que vous naviguerez avec le navigateur de votre smartphone, vous pourrez à tout moment partager un article dans wallabag depuis le menu Partager : vous trouverez une entrée Bag it! qui ajoutera l'article dans wallabag.
+
Lecture
+
Lorsque vous ouvrez l'application, cliquez sur Synchronize : vos articles dernièrement sauvegardés seront ainsi téléchargés sur votre smartphone.
+
Vous n'avez maintenant plus besoin de connexion internet : cliquez sur le bouton List articles pour commencer votre lecture.
+
En bas de chaque article, un bouton Mark as read vous permet d'archiver l'article.
+
Aujourd'hui, la synchronisation ne s'effectue que dans un sens (de wallabag vers l'application), ce qui empêche de marquer comme lu un article sur wallabag depuis votre smartphone.
+
iOS
+
Installation et configuration
+
TODO
+
Utilisation
+
TODO
+
Windows Phone
+
Installation et configuration
+
Vous pouvez télécharger l'application Windows Phone depuis le Windows Store ou directement dans le Store de votre smartphone.
+
Une fois installée, l'application affichera une notification au premier lancement, demandant la configuration du serveur wallabag. Rendez-vous dans la partie Configuration de l'application en appuyant sur les 3 petits points du menu en bas de l'écran, puis renseignez les champs URL (Adresse complète de votre installation de wallabag ou de votre compte Framabag), User ID (très souvent, il vous faudra mettre 1 comme valeur).
+Si vous avez créé plusieurs comptes depuis wallabag, il faudra saisir l'identifiant du compte que vous souhaitez connecter à votre application) et Token (recopiez bien tous les caractères du token, disponible dans la configuration de wallabag).
+Enfin, sauvegardez les paramètres entrés.
Dans les préférences de l'extension, renseignez l'URL complète de votre installation de wallabag ou de votre compte Framabag.
+
Personnalisez la barre d'outils de Firefox pour ajouter wallabag (icône w). Lorsque vous vous trouvez sur un article que vous souhaitez sauvegarder, cliquez sur cette icône : une nouvelle fenêtre s'ouvrira pour ajouter l'article et elle se refermera automatiquement.
+
Chrome
+
Téléchargez l'extension Chrome sur le site dédié et installez-la comme toute autre extension Chrome.
+
Dans les options de l'extension, renseignez l'URL complète de votre installation de wallabag ou de votre compte Framabag.
+
Lors de l'installation de l'extension, une nouvelle icône est apparue dans la barre d'outils de Chrome, une icône w. Lorsque vous vous trouvez sur un article que vous souhaitez sauvegarder, cliquez sur cette icône : une popup s'ouvrira et vous confirmera que l'article a bien été sauvegardé.
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/fr/Utilisateur/un_article_est_mal_affiche.html b/docs/fr/Utilisateur/un_article_est_mal_affiche.html
new file mode 100644
index 000000000..3a4c07fe5
--- /dev/null
+++ b/docs/fr/Utilisateur/un_article_est_mal_affiche.html
@@ -0,0 +1,216 @@
+
+
+
+
+
+
+ wallabag - Mon article s'affiche mal dans wallabag
+
+
+
+
+
+
+
+
+
+
+
+ wallabag
+
+ Mon article s'affiche mal dans wallabag
+
+
+ EN - FR - DE - RU
+
+
+
+
+
+
+
+
+
+
+
+
+
Mon article s'affiche mal dans wallabag
+
Si vous pensez que wallabag récupère mal le contenu d'un article (texte absent ou incomplet), nous vous proposons plusieurs possibilités.
+
Demande d'aide
+
Que ça soit par mail ou via un ticket, n'oubliez pas de nous donner certaines informations qui sont importantes pour que nous puissions résoudre le problème au mieux :
+
+
l'URL de l'article concerné
+
ce que wallabag affiche
+
ce à quoi vous vous attendiez
+
la version de wallabag ou alors si vous utilisez Framabag
+
+
Ouvrir un ticket sur github
+
Pour ouvrir un nouveau ticket, il faut aller sur github. Un compte est nécessaire.
+N'oubliez pas de nous envoyer les informations ci-dessus.
+
Nous envoyer un email
+
Envoyez-nous un lien à l'adresse hello@wallabag.org.
+N'oubliez pas de nous envoyer les informations ci-dessus.
+
Résoudre ce problème d'affichage
+
TODO
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/fr/contribuer_au_projet.html b/docs/fr/contribuer_au_projet.html
new file mode 100644
index 000000000..26c5a9b2a
--- /dev/null
+++ b/docs/fr/contribuer_au_projet.html
@@ -0,0 +1,234 @@
+
+
+
+
+
+
+ wallabag - Contribuer au projet
+
+
+
+
+
+
+
+
+
+
+
+ wallabag
+
+ Contribuer au projet
+
+
+ EN - FR - DE - RU
+
+
+
+
+
+
+
+
+
+
+
+
+
Contribuer au projet
+
Soumettre des bugs
+
Demande de support
+
Si vous avez un problème lors de l'installation ou de l'utilisation de wallabag (que ça soit l'application web ou les applications pour smartphone), utilisez le site de support http://support.wallabag.org.
+
Nous verrons alors si nous pouvons vous dépanner rapidement ou alors s'il s'agit un nouveau bug qu'il nous faudra corriger.
+
Il est préférable d'utiliser le site de support plutôt que de nous envoyer un mail : le suivi est plus pratique pour vous comme pour nous et la résolution de votre problème pourra resservir pour un autre utilisateur.
+
Créer un nouveau ticket
+
Si vous avez trouvé un bug lors de votre utilisation de wallabag, merci d'ouvrir un nouveau ticket sur Github (un compte est nécessaire).
La documentation que vous êtes en train de lire n'est sûrement pas complète, à jour, traduite dans votre langue. C'est pourquoi nous vous invitons à participer à sa rédaction.
Corriger les bugs, résoudre les problèmes : faire du support
+
Deux possibilités :
+
+
lorsqu'un utilisateur de wallabag pose une nouvelle question sur le site de support, en tant qu'utilisateur avancé de wallabag, vous pouvez lui répondre.
Rien de compliqué ici, parlez de wallabag autour de vous. Utilisez le mot-clé #wallabag sur tous vos réseaux sociaux préférés : twitter, Facebook, Diaspora*, Google+, etc.
+
D'ailleurs, voici la liste de nos comptes sur ces réseaux, si jamais vous voulez nous citer dans un de vos messages :
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/fr/index.html b/docs/fr/index.html
new file mode 100644
index 000000000..866b705e7
--- /dev/null
+++ b/docs/fr/index.html
@@ -0,0 +1,211 @@
+
+
+
+
+
+
+ wallabag - Documentation en français
+
+
+
+
+
+
+
+
+
+
+
+ wallabag
+
+ Documentation en français
+
+
+ EN - FR - DE - RU
+
+
+
+
+
+
+
+
+
+
+
+
+
Documentation en français
+
wallabag est une application de lecture différée : elle permet simplement d'archiver une page web en ne conservant que le contenu. Les éléments superflus (menu, publicité, etc.) sont supprimés.
+
Fonctionnalités
+
+
tout le contenu est archivé : le texte et les photos
Welcome on wallabag documentation. Thanks to this tool, we hope that you can easily use wallabag and work with it.
-
Today, we have two documentations: for users and for developers. Just select your language and good reading!
-Feel free to contribute to this documentation. It's your documentation.
Welcome on wallabag documentation. Thanks to this tool, we hope that you can easily use wallabag and work with it.
+
Today, we have three documentations: for users, for developers and for administrators. Just select your language and good reading!
+Feel free to contribute to this documentation: it's your documentation.
+
This documentation is generated thanks to couscous.io.
Это совсем не сложно: просто рассказывайте о wallabag! Используйте хэштег #wallabag в ваших социальных сетях: twitter, Facebook, Diaspora*, Google+ и т.д.
В меню "настройки" вы можете менять некоторые параметры wallabag.
-
Некоторые вещи не будут освещены здесь, так как для них есть отдельные главы в документации (каналы RSS, импорт из сторонних сервисов, экспорт данных, конвертация в Epub и многопользовательский режим).
-
Тема
-
На вкус и цвет товарищей нет. Поэтому wallabag предлагает вам менять стиль отображения, чтобы угодить каждому.
-
Выберите тему из выпадающего списка и подтвердите выбор, нажав кнопку Обновить.
-
Язык
-
Выберите язык из выпадающего списка и подтвердите выбор, нажав кнопку Обновить.
-
Пароль
-
Введите новый пароль в два соответствующих поля и подтвердите, нажав кнопку Обновить.
-
Вы будете отключены, затем вам нужно будет ввести новый пароль, чтобы получить доступ к wallabag.
-
Очистка кэша
-
Кэш позволяет wallabag ускорять работу некоторых функций.
-
Мы советуем очищать кэш после обновления wallabag. Чтобы сделать это, вам достаточно просто нажать кнопку.
Если вы не хотите или не можете установить Wallabag на свой сервер, мы предлагаем вас создать бесплатный аккаунт на Framabag, где используется наше программное обеспечение: прочитайте об этом здесь (TODO написать Создание аккаунта framabag).
Чтобы убедиться, что ваш веб-сервер удовлетворяет всем требованиям, вы можете запустить файл wallabag_compatibility_test.php, который находится в подпапке install в основной папке wallabag.
-
Установка зависимостей
-
Для корректной работы wallabag нужно установить несколько зависимостей. Чтобы сделать это, вы должны использовать composer. Перейдите в папку с wallabag и запустите следующие команды:
Если вы не можете установить composer (для корректной работы wallabag нужно установить несколько зависимостей), мы предлагаем распаковать файл vendor.zip в вашей папке wallabag.
-
Разрешения
-
Вашему серверу нужен доступ для записи в папках assets, cache и db. В противном случае появится сообщение о невозможности установки.
-
Установка wallabag. Наконец-то.
-
Зайдите на сайт с wallabag из вашего браузера. Если сервер настроен правильно, вы увидите страницу установки.
-
Укажите тип вашей базы данных (sqlite, mysql или postgresql) и, наконец, информацию для вашего аккаунта.
-
Теперь wallabag установлен.
-
Вход в wallabag
-
В вашем браузере откроется страница входа: введите своё имя пользователя и пароль для доступа к своему аккаунту.
Внимание, эта часть только для продвинутых пользователей. Мы будем редактировать важный файл wallabag: inc/poche/config.inc.php. Пожалуйста, сделайте резервную копию этого файла, прежде чем вносить какие-либо изменения.
-Если вы допустите ошибку при редактировании файла wallabag, ваше приложение может перестать работать.
-
Этот файл создаётся во время установки wallabag.
-Пожалуйста, сначала установите wallabag, сделайте резервную копию этого файла и откройте его с помощью Sublime Text вашего любимого редактора.
-
В этом файле определены некоторые параметры, которые вы не можете изменить на странице настроек wallabag.
-
Дополнительные параметры
-
Каждый параметр задан таким образом:
-
@define ('ИМЯ_ПАРАМЕТРА', 'Значение параметра');
-
На каждой строке вам нужно будет менять только Значение параметра.
-
TODO описать все последующие параметры
-
Вот список всех параметров, которые вы можете менять:
-
-
HTTP_PORT (значение по умолчанию 80): Ожидаемое значение: число.
-
SSL_PORT (значение по умолчанию 443): Ожидаемое значение: число.
-
DEBUG_POCHE (значение по умолчанию FALSE): Ожидаемые значения: TRUE или FALSE.
-
DOWNLOAD_PICTURES (значение по умолчанию FALSE): Ожидаемые значения: TRUE или FALSE.
-
SHARE_TWITTER (значение по умолчаниюTRUE): Ожидаемые значения: TRUE или FALSE.
-
SHARE_MAIL (значение по умолчанию TRUE): Ожидаемые значения: TRUE или FALSE.
-
SHARE_SHAARLI (значение по умолчанию FALSE): Ожидаемые значения: TRUE или FALSE.
-
SHAARLI_URL (значение по умолчанию 'http://myshaarliurl.com'): Ожидаемое значение: ваш Shaarli URL.
-
FLATTR (значение по умолчанию TRUE): Ожидаемые значения: TRUE или FALSE.
Это совсем не сложно: просто рассказывайте о wallabag! Используйте хэштег #wallabag в ваших социальных сетях: twitter, Facebook, Diaspora*, Google+ и т.д.
wallabag - это приложение с функцией "отложить на потом": оно сохраняет веб-страницу, оставляя только контент. Навигационные элементы и баннеры удаляются.
+
Особенности
+
+
сохраняет содержимое веб-страницы: текст и изображения.
+
адаптивное веб-приложение
+
вы можете экспортировать статьи в формат ePub
+
благодаря приложениям для смартфонов, вы можете читать сохранённые статьи без подключения к интернету
+
благодаря плагинам к браузерам, вы легко можете сохранять новые ссылки
+
вы можете настроить внешний вид wallabag с помощью множества доступных шаблонов
+
и множество других функций !
+
+
Эта документация написана для того, что вы смогли изучить всё, что можно делать с помощью wallabag.
В меню "настройки" вы можете менять некоторые параметры wallabag.
-
Некоторые вещи не будут освещены здесь, так как для них есть отдельные главы в документации (каналы RSS, импорт из сторонних сервисов, экспорт данных, конвертация в Epub и многопользовательский режим).
-
Тема
-
На вкус и цвет товарищей нет. Поэтому wallabag предлагает вам менять стиль отображения, чтобы угодить каждому.
-
Выберите тему из выпадающего списка и подтвердите выбор, нажав кнопку Обновить.
-
Язык
-
Выберите язык из выпадающего списка и подтвердите выбор, нажав кнопку Обновить.
-
Пароль
-
Введите новый пароль в два соответствующих поля и подтвердите, нажав кнопку Обновить.
-
Вы будете отключены, затем вам нужно будет ввести новый пароль, чтобы получить доступ к wallabag.
-
Очистка кэша
-
Кэш позволяет wallabag ускорять работу некоторых функций.
-
Мы советуем очищать кэш после обновления wallabag. Чтобы сделать это, вам достаточно просто нажать кнопку.
Если вы не хотите или не можете установить Wallabag на свой сервер, мы предлагаем вас создать бесплатный аккаунт на Framabag, где используется наше программное обеспечение: прочитайте об этом здесь (TODO написать Создание аккаунта framabag).
Чтобы убедиться, что ваш веб-сервер удовлетворяет всем требованиям, вы можете запустить файл wallabag_compatibility_test.php, который находится в подпапке install в основной папке wallabag.
-
Установка зависимостей
-
Для корректной работы wallabag нужно установить несколько зависимостей. Чтобы сделать это, вы должны использовать composer. Перейдите в папку с wallabag и запустите следующие команды:
Если вы не можете установить composer (для корректной работы wallabag нужно установить несколько зависимостей), мы предлагаем распаковать файл vendor.zip в вашей папке wallabag.
-
Разрешения
-
Вашему серверу нужен доступ для записи в папках assets, cache и db. В противном случае появится сообщение о невозможности установки.
-
Установка wallabag. Наконец-то.
-
Зайдите на сайт с wallabag из вашего браузера. Если сервер настроен правильно, вы увидите страницу установки.
-
Укажите тип вашей базы данных (sqlite, mysql или postgresql) и, наконец, информацию для вашего аккаунта.
-
Теперь wallabag установлен.
-
Вход в wallabag
-
В вашем браузере откроется страница входа: введите своё имя пользователя и пароль для доступа к своему аккаунту.
Внимание, эта часть только для продвинутых пользователей. Мы будем редактировать важный файл wallabag: inc/poche/config.inc.php. Пожалуйста, сделайте резервную копию этого файла, прежде чем вносить какие-либо изменения.
-Если вы допустите ошибку при редактировании файла wallabag, ваше приложение может перестать работать.
-
Этот файл создаётся во время установки wallabag.
-Пожалуйста, сначала установите wallabag, сделайте резервную копию этого файла и откройте его с помощью Sublime Text вашего любимого редактора.
-
В этом файле определены некоторые параметры, которые вы не можете изменить на странице настроек wallabag.
-
Дополнительные параметры
-
Каждый параметр задан таким образом:
-
@define ('ИМЯ_ПАРАМЕТРА', 'Значение параметра');
-
На каждой строке вам нужно будет менять только Значение параметра.
-
TODO описать все последующие параметры
-
Вот список всех параметров, которые вы можете менять:
-
-
HTTP_PORT (значение по умолчанию 80): Ожидаемое значение: число.
-
SSL_PORT (значение по умолчанию 443): Ожидаемое значение: число.
-
DEBUG_POCHE (значение по умолчанию FALSE): Ожидаемые значения: TRUE или FALSE.
-
DOWNLOAD_PICTURES (значение по умолчанию FALSE): Ожидаемые значения: TRUE или FALSE.
-
SHARE_TWITTER (значение по умолчаниюTRUE): Ожидаемые значения: TRUE или FALSE.
-
SHARE_MAIL (значение по умолчанию TRUE): Ожидаемые значения: TRUE или FALSE.
-
SHARE_SHAARLI (значение по умолчанию FALSE): Ожидаемые значения: TRUE или FALSE.
-
SHAARLI_URL (значение по умолчанию 'http://myshaarliurl.com'): Ожидаемое значение: ваш Shaarli URL.
-
FLATTR (значение по умолчанию TRUE): Ожидаемые значения: TRUE или FALSE.
При использовании wallabag у вас есть несколько способов сохранить статью.
-
С помощью веб-приложения
-
Сначала давайте посмотрим как можно это сделать, используя веб-приложение. В меню есть пункт сохранить ссылку. Нажмите на неё, и появится форма: дальше вам просто нужно ввести адрес ссылки на статью, которую вы хотите сохранить.
-
Нажмите "Сохранить ссылку!", чтобы скопировать сожержимое статьи.
-
При настройках по умолчанию сохраняется только текст. Если вы хотите сохранять на своём сервере копии изображений, вам нужно включить опцию СКАЧИВАТЬ_ИЗОБРАЖЕНИЯ. Подробнее это описано в главе о скрытых настройках.
Букмарклеты используются как инструменты, придающие браузеру дополнительную функциональность.
-
Букмарклеты обычно не возвращают значений, и, таким образом, просто выполняются браузером, имея доступ к открытой в браузере странице. Они могут делать то же самое, что мог бы сделать скрипт, помещённый прямо на странице.
-
-
В меню wallabag нажмите настройки. В первой части этой страницы мы разместили все способы сохранения статей. Вы найдёте букмарклет (это ссылка "прикарманить!"), его можно перетащить в панель закладок вашего браузера.
-Теперь, когда вы захотите сохранить статью, которую просматриваете, вам нужно будет просто нажать на букмарклет и она автоматически сохранится.
-
С вашего смартфона
-
Самое главное
-
Чтобы использовать приложение для смартфона, вам нужно включить RSS каналы в настройках wallabag. Затем будет показана некоторая инфомация, например, ваш ключ доступа. Чтобы узнать подробнее, прочитайте главу об RSS каналах.
-
Android
-
Установка и настройка
-
Вы можете скачать приложение для Android из магазина Google Play или с F-droid. Приложения в этих магазинах абсолютно одинаковы.
-
Запустите приложение, откройте настройки и заполните поля URL (полный адрес установленного вами wallabag или ваш аккаунт Framabag) и ID пользователя (в большинстве случаев нужно просто ввести 1). Если вы создали несколько аккаунтов в wallabag, вам нужно ввести именно тот, который вы хотите подключить к приложению и ваш ключ авторизации (аккуратно введите все буквы ключа в том же порядке, в каком они отображаются в настройках wallabag).
-
Сохранение статьи
-
Теперь, когда всё корректно настроено, как только вы будете просмтаривать веб-страницы через браузер своего смартфона, вы можете сохранять статьи в wallabag в любое время через меню Поделиться: там вы найдёте пункт "Прикарманить!", который добавит статью в ваш wallabag.
-
Чтение
-
Открыв приложение, нажмите "Синхронизировать": все недавно сохранённые статьи будут загружены на ваш смартфон.
-
Теперь вам не нужно соединение с Интернетом: нажмите на Список статей и начинайте читать.
-
В конце каждой статьи есть кнопка Пометить как прочитанное, с помощью которой вы можете архивировать статьи.
-
Пока синхронизация работает в одном направлении (от сервера wallabag к приложению), что не позволяет помечать статьи на сервере wallabag как прочитанные с вашего смартфона.
-
iOS
-
Установка и настройка
-
TODO
-
Использование
-
TODO
-
Windows Phone
-
Установка и настройка
-
Вы можете скачать приложение для Windows Phone из магазина Windows Store или непосредственно из приложения магазина на вашем смартфоне.
-
После установки приложение покажет вам уведомление о первом запуске, в котором спросит параметры вашего сервера wallabag. Зайдите в Настройки, нажав на три точки в меню в нижней части экрана, затем введите URL (полный адрес вашей установки wallabag или аккаунта Framabag) и Идентификатор пользователя (в большинстве случаев нужно просто ввести 1).
-
Если вы создали несколько аккаунтов в wallabag, вам нужно ввести именно тот, который вы хотите подключить к приложению и ваш ключ авторизации (аккуратно введите все буквы ключа в том же порядке, в каком они отображаются в настройках wallabag).
-
Из вашего браузера
-
Firefox
-
Скачайте дополнение для Firefox на addons.mozilla.org и установите его как любое другое дополнение.
-
В его настройках введите полный URL вашей установки wallabag или аккаунта Framabag.
-
Настройте панель Firefox, добавив туда wallabag (иконка W). Когда вы найдёте статью, которую захотите сохранить, нажмите на иконку: появится новое окно, добавит статью на сервер, затем автоматически закроется.
-
Chrome
-
Скачайте расширение Chrome из магазина и установите его как любое другое.
-
В его настройках введите полный URL вашей установки wallabag или аккаунта Framabag.
-
После установки расширения, на панели Chrome появится новая иконка (W). Когда вы найдёте статью, которую захотите сохранить, нажмите на иконку: появится всплывающее окно с подтверждением, что статья была сохранена.
Если вы не хотите или не можете установить Wallabag на свой сервер, мы предлагаем вас создать бесплатный аккаунт на Framabag, где используется наше программное обеспечение: прочитайте об этом здесь (TODO написать Создание аккаунта framabag).
Чтобы убедиться, что ваш веб-сервер удовлетворяет всем требованиям, вы можете запустить файл wallabag_compatibility_test.php, который находится в подпапке install в основной папке wallabag.
+
Установка зависимостей
+
Для корректной работы wallabag нужно установить несколько зависимостей. Чтобы сделать это, вы должны использовать composer. Перейдите в папку с wallabag и запустите следующие команды:
Если вы не можете установить composer (для корректной работы wallabag нужно установить несколько зависимостей), мы предлагаем распаковать файл vendor.zip в вашей папке wallabag.
+
Разрешения
+
Вашему серверу нужен доступ для записи в папках assets, cache и db. В противном случае появится сообщение о невозможности установки.
+
Установка wallabag. Наконец-то.
+
Зайдите на сайт с wallabag из вашего браузера. Если сервер настроен правильно, вы увидите страницу установки.
+
Укажите тип вашей базы данных (sqlite, mysql или postgresql) и, наконец, информацию для вашего аккаунта.
+
Теперь wallabag установлен.
+
Вход в wallabag
+
В вашем браузере откроется страница входа: введите своё имя пользователя и пароль для доступа к своему аккаунту.
+
Пользуйтесь!
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/ru/User_documentation/Save_your_first_article.html b/docs/ru/пользователя/03_Сохраните_свою_первую_статью.html
similarity index 53%
rename from docs/ru/User_documentation/Save_your_first_article.html
rename to docs/ru/пользователя/03_Сохраните_свою_первую_статью.html
index 04fb15fbd..8de942946 100644
--- a/docs/ru/User_documentation/Save_your_first_article.html
+++ b/docs/ru/пользователя/03_Сохраните_свою_первую_статью.html
@@ -1,138 +1,106 @@
-
-
-
-
-
- Save your first article
-
-
-
-
-
-
-
+
+
+
+
-
-
-
-
-
-
-
-
При использовании wallabag у вас есть несколько способов сохранить статью.
-
С помощью веб-приложения
+
С помощью веб-приложения
Сначала давайте посмотрим как можно это сделать, используя веб-приложение. В меню есть пункт сохранить ссылку. Нажмите на неё, и появится форма: дальше вам просто нужно ввести адрес ссылки на статью, которую вы хотите сохранить.
-
Нажмите "Сохранить ссылку!", чтобы скопировать сожержимое статьи.
+
Нажмите "Сохранить ссылку!", чтобы скопировать сожержимое статьи.
При настройках по умолчанию сохраняется только текст. Если вы хотите сохранять на своём сервере копии изображений, вам нужно включить опцию СКАЧИВАТЬ_ИЗОБРАЖЕНИЯ. Подробнее это описано в главе о скрытых настройках.
Букмарклеты используются как инструменты, придающие браузеру дополнительную функциональность.
Букмарклеты обычно не возвращают значений, и, таким образом, просто выполняются браузером, имея доступ к открытой в браузере странице. Они могут делать то же самое, что мог бы сделать скрипт, помещённый прямо на странице.
-
В меню wallabag нажмите настройки. В первой части этой страницы мы разместили все способы сохранения статей. Вы найдёте букмарклет (это ссылка "прикарманить!"), его можно перетащить в панель закладок вашего браузера.
+
В меню wallabag нажмите настройки. В первой части этой страницы мы разместили все способы сохранения статей. Вы найдёте букмарклет (это ссылка "прикарманить!"), его можно перетащить в панель закладок вашего браузера.
Теперь, когда вы захотите сохранить статью, которую просматриваете, вам нужно будет просто нажать на букмарклет и она автоматически сохранится.
-
С вашего смартфона
-
Самое главное
+
С вашего смартфона
+
Самое главное
Чтобы использовать приложение для смартфона, вам нужно включить RSS каналы в настройках wallabag. Затем будет показана некоторая инфомация, например, ваш ключ доступа. Чтобы узнать подробнее, прочитайте главу об RSS каналах.
-
Android
-
Установка и настройка
+
Android
+
Установка и настройка
Вы можете скачать приложение для Android из магазина Google Play или с F-droid. Приложения в этих магазинах абсолютно одинаковы.
Запустите приложение, откройте настройки и заполните поля URL (полный адрес установленного вами wallabag или ваш аккаунт Framabag) и ID пользователя (в большинстве случаев нужно просто ввести 1). Если вы создали несколько аккаунтов в wallabag, вам нужно ввести именно тот, который вы хотите подключить к приложению и ваш ключ авторизации (аккуратно введите все буквы ключа в том же порядке, в каком они отображаются в настройках wallabag).
-
Сохранение статьи
-
Теперь, когда всё корректно настроено, как только вы будете просмтаривать веб-страницы через браузер своего смартфона, вы можете сохранять статьи в wallabag в любое время через меню Поделиться: там вы найдёте пункт "Прикарманить!", который добавит статью в ваш wallabag.
-
Чтение
-
Открыв приложение, нажмите "Синхронизировать": все недавно сохранённые статьи будут загружены на ваш смартфон.
+
Сохранение статьи
+
Теперь, когда всё корректно настроено, как только вы будете просмтаривать веб-страницы через браузер своего смартфона, вы можете сохранять статьи в wallabag в любое время через меню Поделиться: там вы найдёте пункт "Прикарманить!", который добавит статью в ваш wallabag.
+
Чтение
+
Открыв приложение, нажмите "Синхронизировать": все недавно сохранённые статьи будут загружены на ваш смартфон.
Теперь вам не нужно соединение с Интернетом: нажмите на Список статей и начинайте читать.
В конце каждой статьи есть кнопка Пометить как прочитанное, с помощью которой вы можете архивировать статьи.
Пока синхронизация работает в одном направлении (от сервера wallabag к приложению), что не позволяет помечать статьи на сервере wallabag как прочитанные с вашего смартфона.
-
iOS
-
Установка и настройка
+
iOS
+
Установка и настройка
TODO
-
Использование
+
Использование
TODO
-
Windows Phone
-
Установка и настройка
+
Windows Phone
+
Установка и настройка
Вы можете скачать приложение для Windows Phone из магазина Windows Store или непосредственно из приложения магазина на вашем смартфоне.
После установки приложение покажет вам уведомление о первом запуске, в котором спросит параметры вашего сервера wallabag. Зайдите в Настройки, нажав на три точки в меню в нижней части экрана, затем введите URL (полный адрес вашей установки wallabag или аккаунта Framabag) и Идентификатор пользователя (в большинстве случаев нужно просто ввести 1).
Если вы создали несколько аккаунтов в wallabag, вам нужно ввести именно тот, который вы хотите подключить к приложению и ваш ключ авторизации (аккуратно введите все буквы ключа в том же порядке, в каком они отображаются в настройках wallabag).
-
Из вашего браузера
-
Firefox
+
Из вашего браузера
+
Firefox
Скачайте дополнение для Firefox на addons.mozilla.org и установите его как любое другое дополнение.
В его настройках введите полный URL вашей установки wallabag или аккаунта Framabag.
Настройте панель Firefox, добавив туда wallabag (иконка W). Когда вы найдёте статью, которую захотите сохранить, нажмите на иконку: появится новое окно, добавит статью на сервер, затем автоматически закроется.
-
Chrome
+
Chrome
Скачайте расширение Chrome из магазина и установите его как любое другое.
В его настройках введите полный URL вашей установки wallabag или аккаунта Framabag.
-
После установки расширения, на панели Chrome появится новая иконка (W). Когда вы найдёте статью, которую захотите сохранить, нажмите на иконку: появится всплывающее окно с подтверждением, что статья была сохранена.
-
-
-
+
После установки расширения, на панели Chrome появится новая иконка (W). Когда вы найдёте статью, которую захотите сохранить, нажмите на иконку: появится всплывающее окно с подтверждением, что статья была сохранена.
В меню "настройки" вы можете менять некоторые параметры wallabag.
+
Некоторые вещи не будут освещены здесь, так как для них есть отдельные главы в документации (каналы RSS, импорт из сторонних сервисов, экспорт данных, конвертация в Epub и многопользовательский режим).
+
Тема
+
На вкус и цвет товарищей нет. Поэтому wallabag предлагает вам менять стиль отображения, чтобы угодить каждому.
+
Выберите тему из выпадающего списка и подтвердите выбор, нажав кнопку Обновить.
+
Язык
+
Выберите язык из выпадающего списка и подтвердите выбор, нажав кнопку Обновить.
+
Пароль
+
Введите новый пароль в два соответствующих поля и подтвердите, нажав кнопку Обновить.
+
Вы будете отключены, затем вам нужно будет ввести новый пароль, чтобы получить доступ к wallabag.
+
Очистка кэша
+
Кэш позволяет wallabag ускорять работу некоторых функций.
+
Мы советуем очищать кэш после обновления wallabag. Чтобы сделать это, вам достаточно просто нажать кнопку.
Внимание, эта часть только для продвинутых пользователей. Мы будем редактировать важный файл wallabag: inc/poche/config.inc.php. Пожалуйста, сделайте резервную копию этого файла, прежде чем вносить какие-либо изменения.
+Если вы допустите ошибку при редактировании файла wallabag, ваше приложение может перестать работать.
+
Этот файл создаётся во время установки wallabag.
+Пожалуйста, сначала установите wallabag, сделайте резервную копию этого файла и откройте его с помощью Sublime Text вашего любимого редактора.
+
В этом файле определены некоторые параметры, которые вы не можете изменить на странице настроек wallabag.
+
Дополнительные параметры
+
Каждый параметр задан таким образом:
+
@define ('ИМЯ_ПАРАМЕТРА', 'Значение параметра');
+
На каждой строке вам нужно будет менять только Значение параметра.
+
TODO описать все последующие параметры
+
Вот список всех параметров, которые вы можете менять:
+
+
HTTP_PORT (значение по умолчанию 80): Ожидаемое значение: число.
+
SSL_PORT (значение по умолчанию 443): Ожидаемое значение: число.
+
DEBUG_POCHE (значение по умолчанию FALSE): Ожидаемые значения: TRUE или FALSE.
+
DOWNLOAD_PICTURES (значение по умолчанию FALSE): Ожидаемые значения: TRUE или FALSE.
+
SHARE_TWITTER (значение по умолчаниюTRUE): Ожидаемые значения: TRUE или FALSE.
+
SHARE_MAIL (значение по умолчанию TRUE): Ожидаемые значения: TRUE или FALSE.
+
SHARE_SHAARLI (значение по умолчанию FALSE): Ожидаемые значения: TRUE или FALSE.
+
SHAARLI_URL (значение по умолчанию 'http://myshaarliurl.com'): Ожидаемое значение: ваш Shaarli URL.
+
FLATTR (значение по умолчанию TRUE): Ожидаемые значения: TRUE или FALSE.
В меню "настройки" вы можете менять некоторые параметры wallabag.
+
Некоторые вещи не будут освещены здесь, так как для них есть отдельные главы в документации (каналы RSS, импорт из сторонних сервисов, экспорт данных, конвертация в Epub и многопользовательский режим).
+
Тема
+
На вкус и цвет товарищей нет. Поэтому wallabag предлагает вам менять стиль отображения, чтобы угодить каждому.
+
Выберите тему из выпадающего списка и подтвердите выбор, нажав кнопку Обновить.
+
Язык
+
Выберите язык из выпадающего списка и подтвердите выбор, нажав кнопку Обновить.
+
Пароль
+
Введите новый пароль в два соответствующих поля и подтвердите, нажав кнопку Обновить.
+
Вы будете отключены, затем вам нужно будет ввести новый пароль, чтобы получить доступ к wallabag.
+
Очистка кэша
+
Кэш позволяет wallabag ускорять работу некоторых функций.
+
Мы советуем очищать кэш после обновления wallabag. Чтобы сделать это, вам достаточно просто нажать кнопку.
diff --git a/locale/es_ES.utf8/LC_MESSAGES/es_ES.utf8.mo b/locale/es_ES.utf8/LC_MESSAGES/es_ES.utf8.mo
index f43098961..9706ea0e9 100644
Binary files a/locale/es_ES.utf8/LC_MESSAGES/es_ES.utf8.mo and b/locale/es_ES.utf8/LC_MESSAGES/es_ES.utf8.mo differ
diff --git a/locale/es_ES.utf8/LC_MESSAGES/es_ES.utf8.po b/locale/es_ES.utf8/LC_MESSAGES/es_ES.utf8.po
index c08decfe2..3cd495262 100644
--- a/locale/es_ES.utf8/LC_MESSAGES/es_ES.utf8.po
+++ b/locale/es_ES.utf8/LC_MESSAGES/es_ES.utf8.po
@@ -1,250 +1,103 @@
msgid ""
msgstr ""
-"Project-Id-Version: \n"
+"Project-Id-Version: wallabag 1.9\n"
"Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2014-02-25 15:16+0300\n"
+"POT-Creation-Date: 2014-07-26 20:09+0100\n"
"PO-Revision-Date: \n"
-"Last-Translator: Maryana \n"
+"Last-Translator: Thomas Citharel \n"
"Language-Team: \n"
-"Language: \n"
+"Language: es_ES\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
+"X-Poedit-KeywordsList: _;gettext;gettext_noop\n"
+"X-Poedit-SourceCharset: UTF-8\n"
"X-Generator: Poedit 1.5.4\n"
-"X-Poedit-Language: Spanish\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"X-Poedit-Basepath: .\n"
-"X-Poedit-SearchPath-0: /home/mariroz/_DEV/web/wallabag/wallabag-master-testing\n"
msgid "wallabag, a read it later open source system"
-msgstr ""
+msgstr "Wallabag, un sistema open source para leer después"
msgid "login failed: user doesn't exist"
+msgstr "error de inicio de sesión: no existe el usuario"
+
+msgid "save link!"
+msgstr "¡guardar enlace!"
+
+msgid "plop"
+msgstr "pum"
+
+msgid "powered by"
+msgstr "hecho con"
+
+msgid "debug mode is on so cache is off."
+msgstr "el modo de depuración está activo, el caché se encuentra desactivado."
+
+msgid "your wallabag version:"
+msgstr "su versión de Wallabag:"
+
+msgid "storage:"
+msgstr "almacenamiento:"
+
+msgid "login to your wallabag"
+msgstr "iniciar sesión en su Wallabag"
+
+msgid "Login to wallabag"
+msgstr "Iniciar sesión en Wallabag"
+
+msgid "you are in demo mode, some features may be disabled."
msgstr ""
+"se encuentra en modo de demostración, algunas funcionalidades pueden estar "
+"desactivadas."
-msgid "return home"
-msgstr ""
-
-msgid "config"
-msgstr "configuración"
-
-msgid "Saving articles"
-msgstr ""
-
-msgid "There are several ways to save an article:"
-msgstr ""
-
-msgid "read the documentation"
-msgstr "leer la documentación"
-
-msgid "download the extension"
-msgstr ""
-
-msgid "via F-Droid"
-msgstr ""
-
-msgid " or "
-msgstr ""
-
-msgid "via Google Play"
-msgstr ""
-
-msgid "download the application"
-msgstr ""
-
-#, fuzzy
-msgid "By filling this field"
-msgstr "rellenando este campo"
-
-msgid "bag it!"
-msgstr ""
-
-msgid "Bookmarklet: drag & drop this link to your bookmarks bar"
-msgstr ""
-
-msgid "Upgrading wallabag"
-msgstr ""
-
-#, fuzzy
-msgid "Installed version"
-msgstr "ultima versión estable"
-
-#, fuzzy
-msgid "Latest stable version"
-msgstr "ultima versión estable"
-
-#, fuzzy
-msgid "A more recent stable version is available."
-msgstr "una versión estable más reciente está disponible."
-
-#, fuzzy
-msgid "You are up to date."
-msgstr "estás actualizado."
-
-#, fuzzy
-msgid "Latest dev version"
-msgstr "ultima versión de desarollo"
-
-#, fuzzy
-msgid "A more recent development version is available."
-msgstr "una versión de desarollo más reciente está disponible."
-
-msgid "Feeds"
-msgstr ""
-
-msgid "Your feed token is currently empty and must first be generated to enable feeds. Click here to generate it."
-msgstr ""
-
-msgid "Unread feed"
-msgstr ""
-
-#, fuzzy
-msgid "Favorites feed"
-msgstr "preferidos"
-
-#, fuzzy
-msgid "Archive feed"
-msgstr "archivos"
-
-msgid "Your token:"
-msgstr ""
-
-msgid "Your user id:"
-msgstr ""
-
-msgid "You can regenerate your token: generate!."
-msgstr ""
-
-#, fuzzy
-msgid "Change your theme"
-msgstr "Modificar tu contraseña"
-
-msgid "Theme:"
-msgstr ""
-
-msgid "Update"
-msgstr "Actualizar"
-
-#, fuzzy
-msgid "Change your language"
-msgstr "Modificar tu contraseña"
-
-msgid "Language:"
-msgstr ""
-
-msgid "Change your password"
-msgstr "Modificar tu contraseña"
-
-msgid "New password:"
-msgstr "Nueva contraseña :"
+msgid "Username"
+msgstr "Nombre de usuario"
msgid "Password"
msgstr "Contraseña"
-msgid "Repeat your new password:"
-msgstr "Repetir la nueva contraseña :"
+msgid "Stay signed in"
+msgstr "Permanecer conectado"
-msgid "Import"
-msgstr "Importar"
+msgid "(Do not check on public computers)"
+msgstr "(No seleccionar en un ordenadores públicos)"
-#, fuzzy
-msgid "Please execute the import script locally as it can take a very long time."
-msgstr "Por favor, ejecute la importación en local, esto puede demorar un tiempo."
+msgid "Sign in"
+msgstr "Iniciar sesión"
-#, fuzzy
-msgid "More info in the official documentation:"
-msgstr "Más información en la documentación oficial :"
+msgid "back to home"
+msgstr "volver a la página de inicio"
-#, fuzzy
-msgid "Import from Pocket"
-msgstr "importación desde Pocket"
+msgid "back"
+msgstr "volver"
-#, php-format
-msgid "(you must have a %s file on your server)"
-msgstr ""
-
-#, fuzzy
-msgid "Import from Readability"
-msgstr "importación desde Readability"
-
-#, fuzzy
-msgid "Import from Instapaper"
-msgstr "importación desde Instapaper"
-
-#, fuzzy
-msgid "Import from wallabag"
-msgstr "importación desde Readability"
-
-#, fuzzy
-msgid "Export your wallabag data"
-msgstr "Exportar sus datos de poche"
-
-msgid "Click here"
-msgstr "Haga clic aquí"
-
-msgid "to download your database."
-msgstr ""
-
-#, fuzzy
-msgid "to export your wallabag data."
-msgstr "para exportar sus datos de poche."
-
-msgid "Cache"
-msgstr ""
-
-msgid "to delete cache."
-msgstr ""
-
-msgid "You can enter multiple tags, separated by commas."
-msgstr ""
-
-msgid "return to article"
-msgstr ""
-
-msgid "plop"
-msgstr "plop"
-
-msgid "You can check your configuration here."
-msgstr ""
-
-msgid "favoris"
-msgstr "preferidos"
+msgid "favorites"
+msgstr "favoritos"
msgid "archive"
-msgstr "archivos"
+msgstr "archivo"
msgid "unread"
msgstr "sin leer"
-msgid "by date asc"
-msgstr "por fecha ascendiente"
-
-msgid "by date"
-msgstr "por fecha"
-
-msgid "by date desc"
-msgstr "por fecha descendiente"
-
-msgid "by title asc"
-msgstr "por titulo ascendiente"
-
-msgid "by title"
-msgstr "por título"
-
-msgid "by title desc"
-msgstr "por título descendiente"
-
msgid "Tag"
-msgstr ""
+msgstr "Etiqueta"
msgid "No articles found."
-msgstr ""
+msgstr "No se encontraron artículos."
+
+msgid "estimated reading time:"
+msgstr "tiempo estimado de lectura:"
+
+msgid "estimated reading time :"
+msgstr "tiempo estimado de lectura:"
-#, fuzzy
msgid "Toggle mark as read"
-msgstr "marcar como leído"
+msgstr "Marcar como leído"
msgid "toggle favorite"
-msgstr "preferido"
+msgstr "marcar como favorito"
msgid "delete"
msgstr "eliminar"
@@ -252,28 +105,417 @@ msgstr "eliminar"
msgid "original"
msgstr "original"
-msgid "estimated reading time:"
-msgstr ""
-
-msgid "mark all the entries as read"
-msgstr ""
+msgid "Mark all the entries as read"
+msgstr "marcar todas las entradas como leídas"
msgid "results"
msgstr "resultados"
+msgid " found for « "
+msgstr " encontrado para « "
+
+msgid "Only one result found for "
+msgstr "Sólo se encontró un resultado para"
+
+msgid "config"
+msgstr "configuracíon"
+
+msgid "Saving articles"
+msgstr "Guardando los artículos"
+
+msgid "There are several ways to save an article:"
+msgstr "Existen varias formas para guardar un artículo:"
+
+msgid "read the documentation"
+msgstr "lea la documentación"
+
+msgid "download the extension"
+msgstr "descargar la extensión"
+
+msgid "via F-Droid"
+msgstr "vía F-Droid"
+
+msgid " or "
+msgstr "o"
+
+msgid "via Google Play"
+msgstr "vía Google Play"
+
+msgid "download the application"
+msgstr "descargar la aplicación"
+
+msgid "By filling this field"
+msgstr "Al completar este campo"
+
+msgid "bag it!"
+msgstr "¡embólselo!"
+
+msgid "Bookmarklet: drag & drop this link to your bookmarks bar"
+msgstr "Bookmarklet: arrastre y suelte este enlace en su barra de marcadores"
+
+msgid "Upgrading wallabag"
+msgstr "Actualizar Wallabag"
+
+msgid "Installed version"
+msgstr "Versión instalada"
+
+msgid "Latest stable version"
+msgstr "Última versión estable"
+
+msgid "A more recent stable version is available."
+msgstr "Está disponible una nueva versión estable."
+
+msgid "You are up to date."
+msgstr "Está actualizado."
+
+msgid "Last check:"
+msgstr "Última verificación:"
+
+msgid "Latest dev version"
+msgstr "Última versión de desarrollo"
+
+msgid "A more recent development version is available."
+msgstr "Está disponible una nueva versión de desarrollo."
+
+msgid "You can clear cache to check the latest release."
+msgstr "Puede limpiar el caché para verificar la última versión disponible."
+
+msgid "Feeds"
+msgstr "Feeds"
+
+msgid ""
+"Your feed token is currently empty and must first be generated to enable "
+"feeds. Click here to generate it."
+msgstr ""
+"El token para sus feeds actualmente está vacío y debe generarlo primero para "
+"habilitar los feeds. Haga clic aquí para "
+"generarlo."
+
+msgid "Unread feed"
+msgstr "Feeds sin leer"
+
+msgid "Favorites feed"
+msgstr "Feeds favoritos"
+
+msgid "Archive feed"
+msgstr "Feeds archivados"
+
+msgid "Your token:"
+msgstr "Su token:"
+
+msgid "Your user id:"
+msgstr "Su id de usuario:"
+
+msgid ""
+"You can regenerate your token: generate!"
+"."
+msgstr ""
+"Puede generar su token: ¡generar!."
+
+msgid "Change your theme"
+msgstr "Cambiar su tema"
+
+msgid "Theme:"
+msgstr "Tema:"
+
+msgid "Update"
+msgstr "Actualizar"
+
+msgid "Change your language"
+msgstr "Cambiar su idioma"
+
+msgid "Language:"
+msgstr "Idioma:"
+
+msgid "Change your password"
+msgstr "Cambiar su contraseña"
+
+msgid "New password:"
+msgstr "Nueva contraseña:"
+
+msgid "Repeat your new password:"
+msgstr "Ingrese nuevamente la nueva contraseña:"
+
+msgid "Import"
+msgstr "Importar"
+
+msgid ""
+"You can import your Pocket, Readability, Instapaper, Wallabag or any data in "
+"appropriate json or html format."
+msgstr ""
+"Puede importar desde Pocket, Readability, Instapaper, Wallabag o cualquier "
+"tipo de dato en formato json o html."
+
+msgid ""
+"Please select export file on your computer and press \"Import\" button below."
+" Wallabag will parse your file, insert all URLs and start fetching of "
+"articles if required. Fetching process is controlled by two constants in "
+"your config file: IMPORT_LIMIT (how many articles are fetched at once) and "
+"IMPORT_DELAY (delay between fetch of next batch of articles)."
+msgstr ""
+"Por favor, seleccione exportar el archivo a su equipo y pulse el botón "
+"\"Importar\" el cual que se ubica más abajo. Wallabag analizará su "
+"archivo, insertará todos los enlaces URL y obtendrá los artículos si es "
+"necesario. El Proceso de búsqueda es controlado por dos constantes en su "
+"archivo de configuración: IMPORT_LIMIT (cuántos artículos se obtendrán a la "
+"vez) e IMPORT_DELAY (el lapso de tiempo que debe esperar para obtener el "
+"próximo lote de artículos)."
+
+msgid "File:"
+msgstr "Archivo:"
+
+msgid "You can click here to fetch content for articles with no content."
+msgstr ""
+"Puede hacer clic aquí para obtener el contenido de los artículos sin "
+"contenido."
+
+msgid "Export your wallabag data"
+msgstr "Exportar sus datos desde Wallabag"
+
+msgid "Click here"
+msgstr "Haga clic aquí"
+
+msgid "to download your database."
+msgstr "para descargar su base de datos."
+
+msgid "to export your wallabag data."
+msgstr "para exportar sus datos desde Wallabag."
+
+msgid "Cache"
+msgstr "Caché"
+
+msgid "to delete cache."
+msgstr "eliminar el caché."
+
+msgid "Add user"
+msgstr "Agregar usuario"
+
+msgid "Add a new user :"
+msgstr "Agregar un nuevo usuario:"
+
+msgid "Login for new user"
+msgstr "Inicio de sesión para el nuevo usuario"
+
+msgid "Login"
+msgstr "Inicio de sesión"
+
+msgid "Password for new user"
+msgstr "Contraseña para el nuevo usuario"
+
+msgid "Email for new user (not required)"
+msgstr "Correo electrónico (no requerido)"
+
+msgid "Send"
+msgstr "Enviar"
+
+msgid "Delete account"
+msgstr "Eliminar cuenta"
+
+msgid "You can delete your account by entering your password and validating."
+msgstr "Puede eliminar su cuenta al introducir su contraseña y validarla."
+
+msgid "Be careful, data will be erased forever (that is a very long time)."
+msgstr ""
+"Tenga cuidado, los datos serán borrados para siempre (lo cual es un tiempo "
+"muy largo)."
+
+msgid "Type here your password"
+msgstr "Introduzca aquí su contraseña"
+
+msgid "You are the only user, you cannot delete your own account."
+msgstr "Es el único usuario, no puede eliminar su propia cuenta."
+
+msgid ""
+"To completely remove wallabag, delete the wallabag folder on your web server "
+"(and eventual databases)."
+msgstr ""
+"Para eliminar completamente Wallabag, borre la carpeta wallabag en su "
+"servidor web (y eventualmente las bases de datos)."
+
+msgid "Save a link"
+msgstr "Guardar un enlace"
+
+msgid "Return home"
+msgstr "Volver a la página de inicio"
+
+msgid "Back to top"
+msgstr "Volver arriba"
+
+msgid "Mark as read"
+msgstr "Marcar como leído"
+
+msgid "Favorite"
+msgstr "Favorito"
+
+msgid "Toggle favorite"
+msgstr "Marcar como favorito"
+
+msgid "Delete"
+msgstr "Eliminar"
+
+msgid "Tweet"
+msgstr "Tuitear"
+
+msgid "Email"
+msgstr "Enviar por correo electrónico"
+
+msgid "Email (not required)"
+msgstr "Correo electrónico (no requerido)"
+
+msgid "shaarli"
+msgstr "Shaarli"
+
+msgid "flattr"
+msgstr "Flattr"
+
+msgid "Print"
+msgstr "Imprimir"
+
+msgid "Does this article appear wrong?"
+msgstr "¿Este artículo no se muestra correctamente?"
+
+msgid "tags:"
+msgstr "etiquetas:"
+
+msgid "Add tags:"
+msgstr "Agregar etiquetas:"
+
+msgid "no tags"
+msgstr "sin etiquetas"
+
+msgid "The tag has been applied successfully"
+msgstr "La etiqueta se ha aplicado exitosamente"
+
+msgid "interview"
+msgstr "entrevista"
+
+msgid "editorial"
+msgstr "editorial"
+
+msgid "video"
+msgstr "vídeo"
+
+msgid "Edit tags"
+msgstr "Editar etiquetas"
+
+msgid "favoris"
+msgstr "favoritos"
+
+msgid "mark all the entries as read"
+msgstr "marcar todas las entradas como leídas"
+
+msgid "toggle view mode"
+msgstr "Cambiar el modo de visualización "
+
+msgid "return home"
+msgstr "volver a la página de inicio"
+
+# Please define the meaning of the "poching" word or provide a synonym. Its meaning is not clear.
+#, fuzzy
+msgid "Poching a link"
+msgstr "Poching un enlace"
+
+msgid "by filling this field"
+msgstr "al completar este campo"
+
+msgid "bookmarklet: drag & drop this link to your bookmarks bar"
+msgstr "bookmarklet: arrastre y suelte este enlace en su barra de marcadores"
+
+msgid "your version"
+msgstr "su versión"
+
+msgid "latest stable version"
+msgstr "última versión estable"
+
+msgid "a more recent stable version is available."
+msgstr "está disponible una nueva versión estable."
+
+msgid "you are up to date."
+msgstr "Está actualizado."
+
+msgid "latest dev version"
+msgstr "última versión de desarrollo"
+
+msgid "a more recent development version is available."
+msgstr "está disponible una nueva versión de desarrollo."
+
+msgid "Please execute the import script locally, it can take a very long time."
+msgstr ""
+"Por favor, ejecute el script de importación localmente, esto puede tardar un "
+"tiempo."
+
+msgid "More infos in the official doc:"
+msgstr "Más información en la documentación oficial:"
+
+msgid "import from Pocket"
+msgstr "importar desde Pocket"
+
+#, php-format
+msgid "(you must have a %s file on your server)"
+msgstr "(debe tener un archivo %s en su servidor)"
+
+msgid "import from Readability"
+msgstr "importar desde Readability"
+
+msgid "import from Instapaper"
+msgstr "importar desde Instapaper"
+
+msgid "Start typing for auto complete."
+msgstr "Comience a escribir para autocompletar."
+
+msgid "You can enter multiple tags, separated by commas."
+msgstr "Puede introducir múltiples etiquetas, separadas por comas."
+
+msgid "return to article"
+msgstr "volver al artículo"
+
+msgid "by date asc"
+msgstr "por fecha ascendente"
+
+msgid "by date"
+msgstr "por fecha"
+
+msgid "by date desc"
+msgstr "por fecha descendente"
+
+msgid "by title asc"
+msgstr "por título ascendente"
+
+msgid "by title"
+msgstr "por título"
+
+msgid "by title desc"
+msgstr "por título descendente"
+
+msgid "home"
+msgstr "página de inicio"
+
+msgid "tags"
+msgstr "etiquetas"
+
+msgid "save a link"
+msgstr "guardar un enlace"
+
+msgid "search"
+msgstr "búsqueda"
+
+msgid "logout"
+msgstr "cerrar sesión"
+
msgid "installation"
msgstr "instalación"
-#, fuzzy
msgid "install your wallabag"
-msgstr "instala tu Poche"
+msgstr "instale su Wallabag"
-#, fuzzy
-msgid "wallabag is still not installed. Please fill the below form to install it. Don't hesitate to read the documentation on wallabag website."
-msgstr "Poche todavia no està instalado. Por favor, completa los campos siguientes para instalarlo. No dudes de leer la documentación en el sitio de Poche."
-
-msgid "Login"
-msgstr "Nombre de usuario"
+msgid ""
+"wallabag is still not installed. Please fill the below form to install it. "
+"Don't hesitate to read the documentation "
+"on wallabag website."
+msgstr ""
+"Wallabag todavía no se encuentra instalado. Por favor, complete los "
+"siguientes campos para instalarlo. No dude en leer la documentación en el sitio oficial de wallabag."
msgid "Repeat your password"
msgstr "Repita su contraseña"
@@ -281,283 +523,355 @@ msgstr "Repita su contraseña"
msgid "Install"
msgstr "Instalar"
-#, fuzzy
-msgid "login to your wallabag"
-msgstr "conectarse a tu Poche"
-
-msgid "Login to wallabag"
+msgid ""
+"You can check your configuration "
+"here."
msgstr ""
+"Puede verificar su configuración "
+"aquí."
-msgid "you are in demo mode, some features may be disabled."
-msgstr "este es el modo de demostración, algunas funcionalidades pueden estar desactivadas."
+msgid "Tags"
+msgstr "Etiquetas"
-msgid "Username"
-msgstr ""
-
-msgid "Stay signed in"
-msgstr "Seguir conectado"
-
-msgid "(Do not check on public computers)"
-msgstr "(no marcar en un ordenador público)"
-
-msgid "Sign in"
-msgstr "Iniciar sesión"
-
-msgid "favorites"
-msgstr "preferidos"
-
-msgid "estimated reading time :"
-msgstr ""
-
-msgid "Mark all the entries as read"
-msgstr ""
-
-msgid "Return home"
-msgstr ""
-
-#, fuzzy
-msgid "Back to top"
-msgstr "volver arriba"
-
-#, fuzzy
-msgid "Mark as read"
-msgstr "marcar como leído"
-
-#, fuzzy
-msgid "Favorite"
-msgstr "preferidos"
-
-#, fuzzy
-msgid "Toggle favorite"
-msgstr "preferido"
-
-#, fuzzy
-msgid "Delete"
-msgstr "eliminar"
-
-#, fuzzy
-msgid "Tweet"
-msgstr "tweetear"
-
-#, fuzzy
-msgid "Email"
-msgstr "enviar por mail"
-
-msgid "shaarli"
-msgstr "shaarli"
-
-msgid "flattr"
-msgstr "flattr"
-
-#, fuzzy
-msgid "Does this article appear wrong?"
-msgstr "este articulo no se ve bien?"
-
-msgid "tags:"
-msgstr ""
-
-msgid "Edit tags"
-msgstr ""
-
-msgid "save link!"
-msgstr ""
-
-msgid "home"
-msgstr "inicio"
-
-msgid "tags"
-msgstr ""
-
-msgid "logout"
-msgstr "cerrar sesión"
-
-msgid "powered by"
-msgstr "hecho con"
-
-msgid "debug mode is on so cache is off."
-msgstr "el modo de depuración está activado, así que la cache está desactivada."
-
-#, fuzzy
-msgid "your wallabag version:"
-msgstr "su versión"
-
-msgid "storage:"
-msgstr "almacenamiento:"
-
-msgid "save a link"
-msgstr ""
-
-msgid "back to home"
-msgstr "volver a la página de inicio"
+msgid "No link available here!"
+msgstr "¡No hay ningún enlace disponible!"
msgid "toggle mark as read"
msgstr "marcar como leído"
msgid "tweet"
-msgstr "tweetear"
+msgstr "tuitear"
msgid "email"
-msgstr "enviar por mail"
+msgstr "enviar por email"
msgid "this article appears wrong?"
-msgstr "este articulo no se ve bien?"
+msgstr "¿este artículo no se muestra correctamente?"
-msgid "No link available here!"
-msgstr "¡No hay ningún enlace disponible por aquí!"
+msgid "Search"
+msgstr "Búsqueda"
-msgid "Poching a link"
-msgstr "Pochear un enlace"
+msgid "Download required for "
+msgstr "Descarga requerida para"
-msgid "by filling this field"
-msgstr "rellenando este campo"
+msgid "records"
+msgstr "archivos"
-msgid "bookmarklet: drag & drop this link to your bookmarks bar"
+msgid "Downloading next "
+msgstr "Descargando siguientes"
+
+msgid "articles, please wait"
+msgstr "artículos, por favor, espere"
+
+msgid "Enter your search here"
+msgstr "Ingrese su búsqueda aquí"
+
+#, php-format
+msgid ""
+"The new user %s has been installed. Do you want to logout ?"
msgstr ""
+"El nuevo usuario %s ha sido instalado. ¿Desea cerrar la "
+"sesión?"
-msgid "your version"
-msgstr "su versión"
+#, php-format
+msgid "Error : An user with the name %s already exists !"
+msgstr "Error: ¡Ya existe un usuario con el nombre %s!"
-msgid "latest stable version"
-msgstr "ultima versión estable"
+#, php-format
+msgid "User %s has been successfully deleted !"
+msgstr "¡El usuario %s ha sido eliminado satisfactoriamente!"
-msgid "a more recent stable version is available."
-msgstr "una versión estable más reciente está disponible."
+msgid "Error : The password is wrong !"
+msgstr "Error: ¡Contraseña errónea!"
-msgid "you are up to date."
-msgstr "estás actualizado."
+msgid "Error : You are the only user, you cannot delete your account !"
+msgstr "Error: ¡Es el único usuario, no puede eliminar su propia cuenta!"
-msgid "latest dev version"
-msgstr "ultima versión de desarollo"
-
-msgid "a more recent development version is available."
-msgstr "una versión de desarollo más reciente está disponible."
-
-msgid "Please execute the import script locally, it can take a very long time."
-msgstr "Por favor, ejecute la importación en local, esto puede demorar un tiempo."
-
-#, fuzzy
-msgid "More infos in the official doc:"
-msgstr "Más información en la documentación oficial :"
-
-msgid "import from Pocket"
-msgstr "importación desde Pocket"
-
-msgid "import from Readability"
-msgstr "importación desde Readability"
-
-msgid "import from Instapaper"
-msgstr "importación desde Instapaper"
-
-msgid "Tags"
-msgstr ""
-
-#, fuzzy
msgid "Untitled"
-msgstr "por título"
+msgstr "Sin título"
msgid "the link has been added successfully"
-msgstr ""
+msgstr "el enlace ha sido añadido satisfactoriamente"
msgid "error during insertion : the link wasn't added"
-msgstr ""
+msgstr "ocurrió un error durante la inserción: el enlace no fue añadido"
msgid "the link has been deleted successfully"
-msgstr ""
+msgstr "el enlace ha sido eliminado satisfactoriamente"
msgid "the link wasn't deleted"
-msgstr ""
+msgstr "el enlace no fue eliminado"
msgid "Article not found!"
-msgstr ""
+msgstr "¡No se encontró el artículo!"
msgid "previous"
-msgstr ""
+msgstr "anterior"
msgid "next"
-msgstr ""
+msgstr "siguiente"
msgid "in demo mode, you can't update your password"
-msgstr ""
+msgstr "en modo de demostración, no puede actualizar su contraseña"
msgid "your password has been updated"
-msgstr ""
+msgstr "su contraseña ha sido actualizada"
-msgid "the two fields have to be filled & the password must be the same in the two fields"
+msgid ""
+"the two fields have to be filled & the password must be the same in the two "
+"fields"
msgstr ""
+"se deben completar ambos campos y la contraseña debe ser la misma para "
+"dichos campos"
msgid "still using the \""
-msgstr ""
+msgstr "continua utilizando el \""
msgid "that theme does not seem to be installed"
-msgstr ""
+msgstr "parece que este tema no se encuentra instalado"
msgid "you have changed your theme preferences"
-msgstr ""
+msgstr "ha cambiado las preferencias de su tema"
msgid "that language does not seem to be installed"
-msgstr ""
+msgstr "parece que este idioma no se encuentra instalado"
msgid "you have changed your language preferences"
-msgstr ""
+msgstr "ha cambiado las preferencias de su idioma"
msgid "login failed: you have to fill all fields"
-msgstr ""
+msgstr "error al iniciar sesión: debe completar todos los campos"
msgid "welcome to your wallabag"
-msgstr ""
+msgstr "bienvenido a su Wallabag"
msgid "login failed: bad login or password"
+msgstr "error al iniciar sesión: nombre de usuario o contraseña incorrecta"
+
+msgid "Untitled - Import - "
+msgstr "Sin título - Importar -"
+
+msgid "click to finish import"
+msgstr "haga clic para completar la importación"
+
+msgid "Articles inserted: "
+msgstr "Artículos insertados:"
+
+msgid ". Please note, that some may be marked as \"read\"."
msgstr ""
+". Por favor, tenga en cuenta que algunos pueden estar marcados como \"leidos"
+"\"."
-#, fuzzy
-msgid "import from instapaper completed"
-msgstr "importación desde Instapaper"
+msgid "Import finished."
+msgstr "Importación finalizada."
-#, fuzzy
-msgid "import from pocket completed"
-msgstr "importación desde Pocket"
+msgid "Undefined"
+msgstr "Sin definir"
-#, fuzzy
-msgid "import from Readability completed. "
-msgstr "importación desde Readability"
-
-#, fuzzy
-msgid "import from Poche completed. "
-msgstr "importación desde Pocket"
-
-msgid "Unknown import provider."
-msgstr ""
-
-msgid "Incomplete inc/poche/define.inc.php file, please define \""
-msgstr ""
-
-msgid "Could not find required \""
-msgstr ""
+msgid "User with this id ("
+msgstr "El usuario con este id ("
msgid "Uh, there is a problem while generating feeds."
-msgstr ""
+msgstr "Oh!, se encontró un problema al momento de generar los feeds."
-#, fuzzy
msgid "Cache deleted."
-msgstr "eliminar"
+msgstr "Caché eliminado."
msgid "Oops, it seems you don't have PHP 5."
+msgstr "Ups!, parece que no cuenta con PHP 5."
+
+msgid "Tag these results as"
+msgstr "Etiquetar estos resultados como"
+
+# ebook
+msgid "Fancy an E-Book ?"
+msgstr "Fantástico ¿un libro electrónico?"
+
+msgid "Click to get all your articles in one ebook :"
+msgstr "Haga clic para obtener todos sus artículos en un libro electrónico:"
+
+msgid "Generate ePub file"
+msgstr "Generar archivo ePub"
+
+msgid "Generate Mobi file"
+msgstr "Generar archivo Mobi"
+
+msgid "Generate PDF file"
+msgstr "Generar archivo PDF"
+
+msgid ""
+"This can take a while and can even fail if you have too many "
+"articles, depending on your server configuration."
msgstr ""
+"Esto puede tomar un momento e incluso puede fallar si tiene "
+"demasiados artículos, depende de la configuración del servidor."
-#~ msgid "poche it!"
-#~ msgstr "pochéalo!"
+msgid "Download the articles from this tag in an epub"
+msgstr "Descargar los artículos de esta etiqueta en un ePub"
-#~ msgid "Updating poche"
-#~ msgstr "Actualizar"
+msgid "Download the articles from this search in an epub"
+msgstr "Descargar los artículos de esta búsqueda en un ePub"
-#~ msgid "create an issue"
-#~ msgstr "crear un ticket"
+msgid "Download the articles from this category in an epub"
+msgstr "Descargar los artículos de esta categoría en un ePub"
-#~ msgid "or"
-#~ msgstr "o"
+msgid "Download the articles from this tag in an ePub file"
+msgstr "Descargar los artículos de esta etiqueta en un archivo ePub"
-#~ msgid "contact us by mail"
-#~ msgstr "contactarnos por mail"
+msgid "Download the articles from this tag in an Mobi file"
+msgstr "Descargar los artículos de esta etiqueta en un archivo Mobi"
-#~ msgid "your poche version:"
-#~ msgstr "tu versión de Poche:"
+msgid "Download the articles from this tag in an PDF file"
+msgstr "Descargar los artículos de esta etiqueta en un archivo PDF"
+
+msgid "Download the articles from this search in an ePub"
+msgstr "Descargar los artículos de esta búsqueda en un ePub"
+
+msgid "Download the articles from this search in a Mobi file"
+msgstr "Descargar los artículos de esta búsqueda en un archivo Mobi"
+
+msgid "Download the articles from this search in a PDF file"
+msgstr "Descargar los artículos de esta búsqueda en un archivo PDF"
+
+msgid "Download the articles from this category in an ePub"
+msgstr "Descargar los artículos de esta categoría en un ePub"
+
+msgid "Download the articles from this category in a Mobi file"
+msgstr "Descargar los artículos de esta categoría en un archivo Mobi"
+
+msgid "Download the articles from this category in a PDF file"
+msgstr "Descargar los artículos de esta categoría en un archivo PDF"
+
+msgid "Download as ePub3"
+msgstr "Descargar como ePub3"
+
+msgid "Download as Mobi"
+msgstr "Descargar como Mobi"
+
+msgid "Download as PDF"
+msgstr "Descargar como PDF"
+
+msgid "All my articles on %s"
+msgstr "Todos mis artículos sobre %s"
+
+# All articles
+msgid "Allarticles"
+msgstr "Todos los artículos"
+
+msgid "Articles tagged %s"
+msgstr "Artículos etiquetados %s"
+
+msgid "Tag %s"
+msgstr "Etiqueta %s"
+
+msgid "Articles in category %s"
+msgstr "Artículos en la categoría %s"
+
+msgid "Category %s"
+msgstr "Categoría %s"
+
+msgid "Articles for search %s"
+msgstr "Artículos encontrados para la búsqueda %s"
+
+msgid "Search %s"
+msgstr "Búsqueda %s"
+
+#, fuzzy
+msgid "wallabag articles book"
+msgstr "Wallabag libro de artículos"
+
+msgid "Some articles saved on my wallabag"
+msgstr "Algunos artículos guardados en mi Wallabag"
+
+msgid "Produced by wallabag with PHPePub"
+msgstr "Producido por Wallabag con PHPePub"
+
+msgid ""
+"Please open an issue"
+"a> if you have trouble with the display of this E-Book on your device."
+msgstr ""
+"Por favor, abra un "
+"reporte si usted tiene problemas con la visualización de este libro "
+"electrónico en su dispositivo."
+
+msgid "Produced by wallabag with PHPMobi"
+msgstr "Producido por Wallabag con PHPMobi"
+
+# registration
+msgid "Hi,"
+msgstr "¡Hola,"
+
+msgid "Hi, %1$s"
+msgstr "¡Hola, %1$s!"
+
+msgid "Someone just created a wallabag account for you on %1$s."
+msgstr "Alguien acaba de crear una cuenta Wallabag para usted en %1$s."
+
+msgid "You've just created a wallabag account on %1$s"
+msgstr "Ha creado una cuenta Wallabag en %1$s"
+
+msgid "Your login is %1$s."
+msgstr "Su inicio de sesión es %1$s."
+
+msgid "Have fun with it !"
+msgstr "¡Diviértase con el!"
+
+msgid ""
+"This is an automatically generated message, no one will answer if you "
+"respond to it."
+msgstr ""
+"Este es un mensaje generado automáticamente, nadie va a contestar si "
+"responde a el."
+
+msgid ""
+"Note : The password has been chosen by the person who created your account. "
+"Get in touch with that person to know your password and change it as soon as "
+"possible"
+msgstr ""
+"Nota: La contraseña ha sido elegida por la persona que creó su cuenta. "
+"Póngase en contacto con esa persona para saber su contraseña y cambiarla lo "
+"antes posible"
+
+msgid ""
+"The new user %1$s has been sent an email at %2$s. You may have to check spam "
+"folder."
+msgstr ""
+"El nuevo usuario %1$s ha enviado un correo electrónico a %2$s. Tal vez tenga "
+"que revisar la carpeta de spam."
+
+msgid "A problem has been encountered while sending the confirmation email"
+msgstr ""
+"Un problema ha sido encontrado al enviar el correo electrónico de "
+"confirmación"
+
+msgid ""
+"The server did not authorize sending a confirmation email, but the user was "
+"created."
+msgstr ""
+"El servidor no autorizó el envío de un correo electrónico de confirmación, "
+"pero el usuario ha sido creado."
+
+#, fuzzy
+msgid ""
+"The user was created, but no email was sent because email was not filled in"
+msgstr ""
+"El usuario ha sido creado, pero no se envió ningún correo electrónico debido "
+"a que el correo electrónico no se llenó en"
+
+msgid "Mail function is disabled. You can't send emails from your server"
+msgstr ""
+"La función de correo está deshabilitada. No puede enviar mensajes de correo "
+"electrónico desde su servidor"
+
+msgid "You didn't set your kindle's email adress !"
+msgstr "¡No ha establecido la dirección de correo electrónico de su kindle!"
+
+msgid "The email has been sent to your kindle !"
+msgstr "¡El correo electrónico ha sido enviado a su kindle!"
+
+msgid "Produced by wallabag with mPDF"
+msgstr "Producido por Wallabag con mPDF"
+
+msgid "Read the rest at"
+msgstr "Leer el resto en"
diff --git a/themes/default/img/default/shaarli.png b/themes/_global/img/icons/shaarli.png
similarity index 100%
rename from themes/default/img/default/shaarli.png
rename to themes/_global/img/icons/shaarli.png
diff --git a/themes/baggy/css/main.css b/themes/baggy/css/main.css
index 91c1ab9f3..e3d98586c 100755
--- a/themes/baggy/css/main.css
+++ b/themes/baggy/css/main.css
@@ -775,6 +775,10 @@ a.add-to-wallabag-link-after:after {
background-image: url('../../_global/img/icons/carrot-icon--white.png');
}
+.icon-image--shaarli {
+ background-image: url('../../_global/img/icons/shaarli.png');
+}
+
/* Diaspora */
.icon-image--diaspora {
background-image: url('../../_global/img/icons/diaspora-icon--black.png');
@@ -906,10 +910,6 @@ blockquote {
background-color: #999;
}
-.shaarli:before {
- content: "*";
-}
-
.return {
text-decoration: none;
margin-top: 1em;
diff --git a/themes/baggy/view.twig b/themes/baggy/view.twig
index a57d1771b..ebc30b693 100755
--- a/themes/baggy/view.twig
+++ b/themes/baggy/view.twig
@@ -17,7 +17,7 @@