mirror of
https://github.com/onionshare/onionshare.git
synced 2025-05-02 06:26:10 -04:00
Update docs poetry deps, and build docs
This commit is contained in:
Micah Lee
parent
1809c58e4d
commit
5973c05c71
33 changed files with 1062 additions and 886 deletions
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
|
@ -8,7 +8,7 @@ msgid ""
|
|||
msgstr ""
|
||||
"Project-Id-Version: OnionShare 2.6\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2022-07-05 10:24+1000\n"
|
||||
"POT-Creation-Date: 2022-10-02 16:17-0700\n"
|
||||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||||
|
|
@ -25,113 +25,113 @@ msgid "Save Tabs"
|
|||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:9
|
||||
msgid "Everything in OnionShare is temporary by default. When OnionShare tabs are closed, addresses no longer exist and can't be used again. Your OnionShare service can also be persistent. If you host a website, persistence means it will be available on the same OnionShare address even if you reboot your computer."
|
||||
msgid "Closing OnionShare tabs you host destroys them, preventing reuse. Persistently hosted websites are available on the same address even if the computer they are shared from is rebooted."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:13
|
||||
msgid "To make any tab persistent, check the \"Save this tab, and automatically open it when I open OnionShare\" box before starting your server. A purple pin icon appears to the left of its server status to tell you the tab is saved."
|
||||
#: ../../source/advanced.rst:12
|
||||
msgid "Make any tab persistent by checking the \"Always open this tab when OnionShare is started\" box before starting your server."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:18
|
||||
#: ../../source/advanced.rst:16
|
||||
msgid "When opening OnionShare, your saved tabs from the prior session will start opened. Each service then can be started manually, and will be available on the same OnionShare address and be protected by the same private key."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:21
|
||||
#: ../../source/advanced.rst:19
|
||||
msgid "If you save a tab, a copy of its onion service secret key is stored on your computer."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:26
|
||||
#: ../../source/advanced.rst:24
|
||||
msgid "Turn Off Private Key"
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:28
|
||||
#: ../../source/advanced.rst:26
|
||||
msgid "By default, all OnionShare services are protected with a private key, which Tor calls \"client authentication\"."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:30
|
||||
#: ../../source/advanced.rst:28
|
||||
msgid "The Tor Browser will ask you to enter your private key when you load an OnionShare service. If you want allow the public to use your service, it's better to disable the private key altogether."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:33
|
||||
#: ../../source/advanced.rst:31
|
||||
msgid "To turn off the private key for any tab, check the \"This is a public OnionShare service (disables private key)\" box before starting the server. Then the server will be public and a private key is not needed to load it in the Tor Browser."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:39
|
||||
#: ../../source/advanced.rst:37
|
||||
msgid "Custom Titles"
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:41
|
||||
#: ../../source/advanced.rst:39
|
||||
msgid "When people load OnionShare services in the Tor Browser they see the default title for each type of service. For example, the default title for chat services is \"OnionShare Chat\"."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:44
|
||||
#: ../../source/advanced.rst:42
|
||||
msgid "If you edit the \"Custom title\" setting before starting a server you can change it."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:47
|
||||
#: ../../source/advanced.rst:45
|
||||
msgid "Scheduled Times"
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:49
|
||||
#: ../../source/advanced.rst:47
|
||||
msgid "OnionShare supports scheduling exactly when a service should start and stop. Before starting a server, click \"Show advanced settings\" in its tab and then check the boxes next to either \"Start onion service at scheduled time\", \"Stop onion service at scheduled time\", or both, and set the respective desired dates and times."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:53
|
||||
#: ../../source/advanced.rst:51
|
||||
msgid "Services scheduled to start in the future display a countdown timer when when the \"Start sharing\" button is clicked. Services scheduled to stop in the future display a countdown timer when started."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:56
|
||||
#: ../../source/advanced.rst:54
|
||||
msgid "**Scheduling an OnionShare service to automatically start can be used as a dead man's switch**. This means your service is made public at a given time in the future if you are not there to prevent it. If nothing happens to you, you can cancel the service before it's scheduled to start."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:62
|
||||
#: ../../source/advanced.rst:60
|
||||
msgid "**Scheduling an OnionShare service to automatically stop limits its exposure**. If you want to share secret info or something that will be outdated, you can do so for selected limited time."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:70
|
||||
#: ../../source/advanced.rst:68
|
||||
msgid "Command-line Interface"
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:72
|
||||
#: ../../source/advanced.rst:70
|
||||
msgid "In addition to its graphical interface, OnionShare has a command-line interface."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:74
|
||||
#: ../../source/advanced.rst:72
|
||||
msgid "You can install just the command-line version of OnionShare using ``pip3``::"
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:78
|
||||
#: ../../source/advanced.rst:76
|
||||
msgid "Note that you will also need the ``tor`` package installed. In macOS, install it with: ``brew install tor``"
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:80
|
||||
#: ../../source/advanced.rst:78
|
||||
msgid "Then run it like this::"
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:84
|
||||
#: ../../source/advanced.rst:82
|
||||
msgid "Info about installing it on different operating systems can be found in the `CLI README file <https://github.com/onionshare/onionshare/blob/develop/cli/README.md>`_ in the Git repository."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:86
|
||||
#: ../../source/advanced.rst:84
|
||||
msgid "If you installed OnionShare using the Snap package, you can also just run ``onionshare.cli`` to access the command-line interface version."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:89
|
||||
#: ../../source/advanced.rst:87
|
||||
msgid "Usage"
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:91
|
||||
#: ../../source/advanced.rst:89
|
||||
msgid "Browse the command-line documentation by running ``onionshare --help``::"
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:153
|
||||
#: ../../source/advanced.rst:151
|
||||
msgid "Keyboard Shortcuts"
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:155
|
||||
#: ../../source/advanced.rst:153
|
||||
msgid "The OnionShare desktop application contains some keyboard shortcuts, for convenience and accessibility::"
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/advanced.rst:160
|
||||
#: ../../source/advanced.rst:158
|
||||
msgid "And from the main mode chooser screen::"
|
||||
msgstr ""
|
||||
|
|
|
|||
|
|
@ -1,113 +0,0 @@
|
|||
# SOME DESCRIPTIVE TITLE.
|
||||
# Copyright (C) Micah Lee, et al.
|
||||
# This file is distributed under the same license as the OnionShare package.
|
||||
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
||||
#
|
||||
#, fuzzy
|
||||
msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: OnionShare 2.5\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2022-03-31 16:39+1100\n"
|
||||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||||
"MIME-Version: 1.0\n"
|
||||
"Content-Type: text/plain; charset=UTF-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
|
||||
#: ../../source/connecting.rst:2
|
||||
msgid "Getting connected to Tor"
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:4
|
||||
msgid "When OnionShare starts, it will present a screen asking you to connect to the Tor network."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:8
|
||||
msgid "You have several choices. You can click Connect to Tor to begin the connection process. If there are no problems with your network, including any attempts to block your access to the Tor network, this should hopefully work the first time."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:10
|
||||
msgid "If you want to manually configure Bridges or other Tor settings before you connect, you can click 'Network Settings'."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:13
|
||||
msgid "Automatic censorship circumvention"
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:15
|
||||
msgid "When OnionShare fails to connect to Tor, it might be because Tor is censored in your country."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:17
|
||||
msgid "If this occurs, a screen will be displayed that will offer you to either 'Use a Bridge' (automatically choosing one for you), or 'Try Again without a Bridge'."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:22
|
||||
msgid "What 'Use a Bridge' does"
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:24
|
||||
msgid "Bridges are a way to connect to the Tor network via intermediate services that are hopefully not blocked by your network provider (whereas normal connections might be)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:26
|
||||
msgid "Clicking 'Use a Bridge' will temporarily use the `Meek <https://gitlab.torproject.org/legacy/trac/-/wikis/doc/meek/>`_ domain-fronting proxy to make a non-Tor connection from your computer to the Tor Project's Censorship Circumvention API. The use of the Meek proxy is to hide the fact that you are trying to find a way to connect to Tor."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:28
|
||||
msgid "Before clicking 'Use a Bridge', you can choose either 'Automatically determine my country from my IP address' or 'Manually select my country'."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:30
|
||||
msgid "If you choose the former option, the Censorship Circumvention API will consider your IP address (yes, your real IP address) to determine what country you might reside in."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:32
|
||||
msgid "Based on the country information, the API will try to automatically find bridges that suit your location."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:36
|
||||
msgid "If you choose to manually select a country, OnionShare will still make a request to the Censorship Circumvention API, but will tell the API the country code. The API will then try to fetch bridges for that country that you specified."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:38
|
||||
msgid "If it finds any such bridges, OnionShare will try to reconnect to Tor using those bridges."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:40
|
||||
msgid "If the API does not find any bridges for your location, OnionShare will ask the API for 'fallback' options. At the time of writing, this is likely to be the obfs4 built-in bridges."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:42
|
||||
msgid "OnionShare will also attempt to use the obfs4 built-in bridges if for some reason it could not connect to the API itself, or the API returned an error."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:44
|
||||
msgid "It's important to note that the requests to the Censorship Circumvention API do not go over the Tor Network (because if you could connect to Tor already, you wouldn't need to connect to the API)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:46
|
||||
msgid "Even though it is hard for an adversary to discover where the Meek request is going, this may still be risky for some users. Therefore, it is an opt-in feature. The use of Meek and non-torified network requests are limited only to making one or two requests to the Censorship Circumvention API. Then Meek is stopped, and all further network requests happen over the Tor network."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:49
|
||||
msgid "What 'Try again without a Bridge' does"
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:51
|
||||
msgid "Clicking 'Try again without a Bridge' will retry the normal OnionShare connection attempt to Tor. It won't talk to the Tor Censorship Circumvention API or use Meek."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:54
|
||||
msgid "Connect to Tor automatically"
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:56
|
||||
msgid "You can toggle on the switch 'Connect to Tor automatically' before clicking 'Connect to Tor'. This means that next time OnionShare starts, it will automatically connect with its Tor connection settings from the last session, instead of presenting you with the connection options."
|
||||
msgstr ""
|
||||
|
||||
#: ../../source/connecting.rst:58
|
||||
msgid "If the connection fails, you can still try bridges or reconfigure Tor via the 'Network Settings'."
|
||||
msgstr ""
|
||||
|
|
@ -8,7 +8,7 @@ msgid ""
|
|||
msgstr ""
|
||||
"Project-Id-Version: OnionShare 2.6\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2022-07-05 10:22+1000\n"
|
||||
"POT-Creation-Date: 2022-10-02 16:17-0700\n"
|
||||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@ msgid ""
|
|||
msgstr ""
|
||||
"Project-Id-Version: OnionShare 2.6\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2022-07-05 10:22+1000\n"
|
||||
"POT-Creation-Date: 2022-10-02 16:17-0700\n"
|
||||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@ msgid ""
|
|||
msgstr ""
|
||||
"Project-Id-Version: OnionShare 2.6\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2022-07-05 10:22+1000\n"
|
||||
"POT-Creation-Date: 2022-10-02 16:17-0700\n"
|
||||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@ msgid ""
|
|||
msgstr ""
|
||||
"Project-Id-Version: OnionShare 2.6\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2022-07-05 10:22+1000\n"
|
||||
"POT-Creation-Date: 2022-10-02 16:17-0700\n"
|
||||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@ msgid ""
|
|||
msgstr ""
|
||||
"Project-Id-Version: OnionShare 2.6\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2022-07-05 10:22+1000\n"
|
||||
"POT-Creation-Date: 2022-10-02 16:17-0700\n"
|
||||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@ msgid ""
|
|||
msgstr ""
|
||||
"Project-Id-Version: OnionShare 2.6\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2022-07-05 10:22+1000\n"
|
||||
"POT-Creation-Date: 2022-10-02 16:17-0700\n"
|
||||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@ msgid ""
|
|||
msgstr ""
|
||||
"Project-Id-Version: OnionShare 2.6\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2022-07-05 10:22+1000\n"
|
||||
"POT-Creation-Date: 2022-10-02 16:17-0700\n"
|
||||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@ msgid ""
|
|||
msgstr ""
|
||||
"Project-Id-Version: OnionShare 2.6\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2022-07-05 10:22+1000\n"
|
||||
"POT-Creation-Date: 2022-10-02 16:17-0700\n"
|
||||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue