瀏覽代碼

gui, man, authors: Update docs, translations, and contributors

Syncthing Release Automation 3 年之前
父節點
當前提交
5f383923df

+ 1 - 1
gui/default/assets/lang/lang-de.json

@@ -28,7 +28,7 @@
     "An external command handles the versioning. It has to remove the file from the shared folder. If the path to the application contains spaces, it should be quoted.": "Ein externer Befehl behandelt die Versionierung. Die Datei aus dem freigegebenen Ordner muss entfernen werden. Wenn der Pfad der Anwendung Leerzeichen enthält, sollte dieser in Anführungszeichen stehen.",
     "Anonymous Usage Reporting": "Anonymer Nutzungsbericht",
     "Anonymous usage report format has changed. Would you like to move to the new format?": "Das Format des anonymen Nutzungsberichts hat sich geändert. Möchten Sie auf das neue Format umsteigen?",
-    "Apply": "Apply",
+    "Apply": "Anwenden",
     "Are you sure you want to continue?": "Sind Sie sicher, dass Sie fortfahren möchten?",
     "Are you sure you want to override all remote changes?": "Sind Sie sicher, dass Sie alle entfernten Änderungen überschreiben möchten?",
     "Are you sure you want to permanently delete all these files?": "Sind Sie sicher, dass Sie all diese Dateien dauerhaft löschen möchten?",

+ 1 - 1
gui/default/assets/lang/lang-hu.json

@@ -28,7 +28,7 @@
     "An external command handles the versioning. It has to remove the file from the shared folder. If the path to the application contains spaces, it should be quoted.": "Külső program kezeli a fájlverzió-követést. Az távolítja el a fájlt a megosztott mappából. Ha az alkalmazás útvonala szóközöket tartalmaz, zárójelezni szükséges az útvonalat.",
     "Anonymous Usage Reporting": "Névtelen felhasználási adatok küldése",
     "Anonymous usage report format has changed. Would you like to move to the new format?": "A névtelen használati jelentés formátuma megváltozott. Szeretnél áttérni az új formátumra?",
-    "Apply": "Apply",
+    "Apply": "Alkalmazás",
     "Are you sure you want to continue?": "Biztosan folytatható?",
     "Are you sure you want to override all remote changes?": "Biztos, hogy felülírható minden távoli módosítás?",
     "Are you sure you want to permanently delete all these files?": "Biztos, hogy véglegesen törölhetőek mindezek a fájlok?",

+ 1 - 1
gui/default/assets/lang/lang-lt.json

@@ -393,7 +393,7 @@
     "Time the item was last modified": "Laikas, kai elementas buvo paskutinį kartą modifikuotas",
     "Today": "Šiandien",
     "Trash Can File Versioning": "Šiukšliadėžės versijų valdymas",
-    "Twitter": "Twitter",
+    "Twitter": "Twitter",
     "Type": "Tipas",
     "UNIX Permissions": "UNIX leidimai",
     "Unavailable": "Neprieinama",

+ 1 - 1
gui/default/assets/lang/lang-tr.json

@@ -28,7 +28,7 @@
     "An external command handles the versioning. It has to remove the file from the shared folder. If the path to the application contains spaces, it should be quoted.": "Harici bir komut sürümlendirmeyi gerçekleştirir. Dosyayı paylaşılan klasörden kaldırmak zorundadır. Eğer uygulama yolu boşluklar içeriyorsa, tırnak içine alınmalıdır.",
     "Anonymous Usage Reporting": "İsimsiz Kullanım Bildirme",
     "Anonymous usage report format has changed. Would you like to move to the new format?": "İsimsiz kullanım raporu biçimi değişti. Yeni biçime geçmek ister misiniz?",
-    "Apply": "Apply",
+    "Apply": "Uygula",
     "Are you sure you want to continue?": "Devam etmek istediğinize emin misiniz?",
     "Are you sure you want to override all remote changes?": "Tüm uzak değişiklikleri geçersiz kılmak istediğinize emin misiniz?",
     "Are you sure you want to permanently delete all these files?": "Tüm bu dosyaları kalıcı olarak silmek istediğinize emin misiniz?",

文件差異過大導致無法顯示
+ 0 - 0
gui/default/syncthing/core/aboutModalView.html


+ 1 - 1
man/stdiscosrv.1

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "STDISCOSRV" "1" "Mar 13, 2022" "v1.19.1" "Syncthing"
+.TH "STDISCOSRV" "1" "Mar 20, 2022" "v1.19.1" "Syncthing"
 .SH NAME
 stdiscosrv \- Syncthing Discovery Server
 .SH SYNOPSIS

+ 1 - 1
man/strelaysrv.1

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "STRELAYSRV" "1" "Mar 13, 2022" "v1.19.1" "Syncthing"
+.TH "STRELAYSRV" "1" "Mar 20, 2022" "v1.19.1" "Syncthing"
 .SH NAME
 strelaysrv \- Syncthing Relay Server
 .SH SYNOPSIS

+ 1 - 1
man/syncthing-bep.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "SYNCTHING-BEP" "7" "Mar 13, 2022" "v1.19.1" "Syncthing"
+.TH "SYNCTHING-BEP" "7" "Mar 20, 2022" "v1.19.1" "Syncthing"
 .SH NAME
 syncthing-bep \- Block Exchange Protocol v1
 .SH INTRODUCTION AND DEFINITIONS

+ 1 - 1
man/syncthing-config.5

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "SYNCTHING-CONFIG" "5" "Mar 13, 2022" "v1.19.1" "Syncthing"
+.TH "SYNCTHING-CONFIG" "5" "Mar 20, 2022" "v1.19.1" "Syncthing"
 .SH NAME
 syncthing-config \- Syncthing Configuration
 .SH SYNOPSIS

+ 1 - 1
man/syncthing-device-ids.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "SYNCTHING-DEVICE-IDS" "7" "Mar 13, 2022" "v1.19.1" "Syncthing"
+.TH "SYNCTHING-DEVICE-IDS" "7" "Mar 20, 2022" "v1.19.1" "Syncthing"
 .SH NAME
 syncthing-device-ids \- Understanding Device IDs
 .sp

+ 45 - 3
man/syncthing-event-api.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "SYNCTHING-EVENT-API" "7" "Mar 13, 2022" "v1.19.1" "Syncthing"
+.TH "SYNCTHING-EVENT-API" "7" "Mar 20, 2022" "v1.19.1" "Syncthing"
 .SH NAME
 syncthing-event-api \- Event API
 .SH DESCRIPTION
@@ -593,6 +593,32 @@ state.
 .fi
 .UNINDENT
 .UNINDENT
+.SS FolderWatchStateChanged
+.sp
+The \fBFolderWatchStateChanged\fP event is emitted when a folder’s watcher routine
+encounters a new error, or when a previous error disappeared after retrying.
+The event contains the ID of the affected folder and textual error messages
+describing the previous (\fBfrom\fP) and the updated (\fBto\fP) error conditions.
+If there was no error in either of these, the respective field is omitted.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+{
+  "id": 123,
+  "type": "FolderWatchStateChanged",
+  "time": "2022\-03\-14T12:34:56.890000000+01:00",
+  "data": {
+    "folder": "default",
+    "from": "Something bad happened.",
+    "to": "Something worse happened."
+  }
+}
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
 .SS ItemFinished
 .sp
 Generated when Syncthing ends synchronizing a file to a newer version. A
@@ -738,8 +764,16 @@ This event is emitted when a listen address changes.
 .sp
 Generated upon scan whenever the local disk has discovered an updated file from the
 previous scan.  This does \fInot\fP include events that are discovered and copied from
-other devices (remote\-change\-detected), only files that were changed on the
+other devices (remotechangedetected), only files that were changed on the
 local filesystem.
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+This event is not included in /rest/events\-get endpoint without
+a mask specified, but needs to be selected explicitly.
+.UNINDENT
+.UNINDENT
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -895,7 +929,15 @@ longer pending for any device.
 .SS RemoteChangeDetected
 .sp
 Generated upon scan whenever a file is locally updated due to a remote change.
-Files that are updated locally produce a local\-change\-detected event.
+Files that are updated locally produce a localchangedetected event.
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+This event is not included in /rest/events\-get endpoint without
+a mask specified, but needs to be selected explicitly.
+.UNINDENT
+.UNINDENT
 .INDENT 0.0
 .INDENT 3.5
 .sp

+ 17 - 2
man/syncthing-faq.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "SYNCTHING-FAQ" "7" "Mar 13, 2022" "v1.19.1" "Syncthing"
+.TH "SYNCTHING-FAQ" "7" "Mar 20, 2022" "v1.19.1" "Syncthing"
 .SH NAME
 syncthing-faq \- Frequently Asked Questions
 .INDENT 0.0
@@ -655,7 +655,22 @@ echo 204800 | sudo tee /proc/sys/fs/inotify/max_user_watches
 .UNINDENT
 .SS How do I reset the GUI password?
 .sp
-If you’ve forgotten/lost the GUI password, you can remove it by deleting the \fB<user>\fP and \fB<password>\fP XML tags from the \fB<gui>\fP block in file \fBconfig.xml\fP\&. This should be done while Syncthing is not running. The location of the file depends on the OS and is described in the configuration documentation.
+If you’ve forgotten / lost the GUI password, you can reset it using the
+\fB\-\-gui\-password\fP (and possibly \fB\-\-gui\-user\fP) options to the
+\fBsyncthing generate\fP subcommand.  This should be done while Syncthing is not
+running.
+.INDENT 0.0
+.IP 1. 3
+Stop Syncthing: \fBsyncthing cli operations shutdown\fP
+.IP 2. 3
+\fBsyncthing generate \-\-gui\-password=myNewPassword \-\-gui\-user=newUserName\fP
+.IP 3. 3
+Restart Syncthing as usual.
+.UNINDENT
+.sp
+\fIAlternatively, in step 2\fP, you can manually delete the \fB<user>\fP and \fB<password>\fP XML tags from the
+\fB<gui>\fP block in file \fBconfig.xml\fP\&.  The location of the file depends on the
+OS and is described in the configuration documentation\&.
 .sp
 For example, the two emphasized lines below would be removed from the file.
 .INDENT 0.0

+ 1 - 1
man/syncthing-globaldisco.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "SYNCTHING-GLOBALDISCO" "7" "Mar 13, 2022" "v1.19.1" "Syncthing"
+.TH "SYNCTHING-GLOBALDISCO" "7" "Mar 20, 2022" "v1.19.1" "Syncthing"
 .SH NAME
 syncthing-globaldisco \- Global Discovery Protocol v3
 .SH ANNOUNCEMENTS

+ 1 - 1
man/syncthing-localdisco.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "SYNCTHING-LOCALDISCO" "7" "Mar 13, 2022" "v1.19.1" "Syncthing"
+.TH "SYNCTHING-LOCALDISCO" "7" "Mar 20, 2022" "v1.19.1" "Syncthing"
 .SH NAME
 syncthing-localdisco \- Local Discovery Protocol v4
 .SH MODE OF OPERATION

+ 1 - 1
man/syncthing-networking.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "SYNCTHING-NETWORKING" "7" "Mar 13, 2022" "v1.19.1" "Syncthing"
+.TH "SYNCTHING-NETWORKING" "7" "Mar 20, 2022" "v1.19.1" "Syncthing"
 .SH NAME
 syncthing-networking \- Firewall Setup
 .SH ROUTER SETUP

+ 1 - 1
man/syncthing-relay.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "SYNCTHING-RELAY" "7" "Mar 13, 2022" "v1.19.1" "Syncthing"
+.TH "SYNCTHING-RELAY" "7" "Mar 20, 2022" "v1.19.1" "Syncthing"
 .SH NAME
 syncthing-relay \- Relay Protocol v1
 .SH WHAT IS A RELAY?

+ 6 - 4
man/syncthing-rest-api.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "SYNCTHING-REST-API" "7" "Mar 13, 2022" "v1.19.1" "Syncthing"
+.TH "SYNCTHING-REST-API" "7" "Mar 20, 2022" "v1.19.1" "Syncthing"
 .SH NAME
 syncthing-rest-api \- REST API
 .sp
@@ -1709,9 +1709,11 @@ This is an expensive call, increasing CPU and RAM usage on the device. Use spari
 .sp
 To receive events, perform a HTTP GET of \fB/rest/events\fP\&.
 .sp
-To filter the event list, in effect creating a specific subscription for
-only the desired event types, add a parameter
-\fBevents=EventTypeA,EventTypeB,...\fP where the event types are any of the event\-types\&.
+To filter the event list, in effect creating a specific subscription for only
+the desired event types, add a parameter \fBevents=EventTypeA,EventTypeB,...\fP
+where the event types are any of the event\-types\&.  If no filter is
+specified, all events \fIexcept\fP /events/localchangedetected and
+/events/remotechangedetected are included.
 .sp
 The optional parameter \fBsince=<lastSeenID>\fP sets the ID of the last event
 you’ve already seen. Syncthing returns a JSON encoded array of event objects,

+ 1 - 1
man/syncthing-security.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "SYNCTHING-SECURITY" "7" "Mar 13, 2022" "v1.19.1" "Syncthing"
+.TH "SYNCTHING-SECURITY" "7" "Mar 20, 2022" "v1.19.1" "Syncthing"
 .SH NAME
 syncthing-security \- Security Principles
 .sp

+ 1 - 1
man/syncthing-stignore.5

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "SYNCTHING-STIGNORE" "5" "Mar 13, 2022" "v1.19.1" "Syncthing"
+.TH "SYNCTHING-STIGNORE" "5" "Mar 20, 2022" "v1.19.1" "Syncthing"
 .SH NAME
 syncthing-stignore \- Prevent files from being synchronized to other nodes
 .SH SYNOPSIS

+ 1 - 1
man/syncthing-versioning.7

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "SYNCTHING-VERSIONING" "7" "Mar 13, 2022" "v1.19.1" "Syncthing"
+.TH "SYNCTHING-VERSIONING" "7" "Mar 20, 2022" "v1.19.1" "Syncthing"
 .SH NAME
 syncthing-versioning \- Keep automatic backups of deleted files by other nodes
 .sp

+ 1 - 1
man/syncthing.1

@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "SYNCTHING" "1" "Mar 13, 2022" "v1.19.1" "Syncthing"
+.TH "SYNCTHING" "1" "Mar 20, 2022" "v1.19.1" "Syncthing"
 .SH NAME
 syncthing \- Syncthing
 .SH SYNOPSIS

部分文件因文件數量過多而無法顯示