OnionShare fejlesztése
Együttműködés
Az OnionShare nyitott Keybase-csapattal rendelkezik, amely megvitatja a projektet, kérdéseket tesz fel, ötleteket és terveket oszt meg, valamint terveket készít a jövőbeli fejlesztésre vonatkozóan. (Ez egy egyszerű módja annak, hogy végpontok között titkosított közvetlen üzeneteket küldjön másoknak az OnionShare közösségben, például OnionShare címeket.) A Keybase használatához töltse le a Keybase alkalmazást , hozzon létre fiókot, és csatlakozzon ehhez a csapathoz. Az alkalmazáson belül lépjen a „Csapatok” elemre, kattintson a „Csatlakozás csapathoz” lehetőségre, és írja be a „Onionshare” kifejezést.
Az OnionShare-nek van egy „levelezőlistája <https://lists.riseup.net/www/subscribe/onionshare-dev>” is a fejlesztők és a tervezők számára, hogy megvitassák a projektet.
Kód beküldése
Az OnionShare forráskódja ebben a Git-tárolóban található: https://github.com/onionshare/onionshare
Ha kóddal szeretne hozzájárulni az OnionShare-hez, érdemes csatlakoznia a Keybase-csapathoz, és ott feltenni kérdéseit arról, amin dolgozni szeretne. Érdemes átnéznie a GitHubon az összes nyitott hibajegyet is, hátha van köztük olyan, amellyel szívesen foglalkozna.
Ha készen áll a kód beküldésére, nyisson egy pull requestet a GitHub-tárolóban, és a projekt egyik karbantartója átnézi, esetleg kérdéseket tesz fel, módosításokat kér, elutasítja, vagy beolvasztja a projektbe.
A fejlesztés megkezdése
Az OnionShare Pythonban készül. Kezdésként klónozza a Git-tárolót a https://github.com/onionshare/onionshare/ címről, majd a parancssoros változat fejlesztői környezetének beállításához olvassa el a cli/README.md fájlt, a grafikus változatéhoz pedig a desktop/README.md fájlt.
Ezek a fájlok tartalmazzák a szükséges technikai utasításokat és parancsokat a függőségek telepítéséhez az Ön platformján, valamint az OnionShare forrásfából való futtatásához.
Hibakeresési tippek
Részletes mód
Fejlesztés közben kényelmes az OnionShare-t terminálból futtatni, és a parancshoz hozzáadni a --verbose (vagy -v) kapcsolót. Ez sok hasznos üzenetet ír ki a terminálba, például amikor bizonyos objektumok inicializálódnak, amikor események történnek (például gombokra kattintanak, beállításokat mentenek vagy töltenek újra be), valamint egyéb hibakeresési információkat. Például:
$ poetry run onionshare-cli -v ~/Documents/roms/nes/Q-bert\ \(USA\).nes
╭───────────────────────────────────────────╮
│ * ▄▄█████▄▄ * │
│ ▄████▀▀▀████▄ * │
│ ▀▀█▀ ▀██▄ │
│ * ▄█▄ ▀██▄ │
│ ▄█████▄ ███ -+- │
│ ███ ▀█████▀ │
│ ▀██▄ ▀█▀ │
│ * ▀██▄ ▄█▄▄ * │
│ * ▀████▄▄▄████▀ │
│ ▀▀█████▀▀ │
│ -+- * │
│ ▄▀▄ ▄▀▀ █ │
│ █ █ ▀ ▀▄ █ │
│ █ █ █▀▄ █ ▄▀▄ █▀▄ ▀▄ █▀▄ ▄▀▄ █▄▀ ▄█▄ │
│ ▀▄▀ █ █ █ ▀▄▀ █ █ ▄▄▀ █ █ ▀▄█ █ ▀▄▄ │
│ │
│ v2.4.1 │
│ │
│ https://onionshare.org/ │
╰───────────────────────────────────────────╯
[Sep 09 2021 19:13:20] Settings.__init__
[Sep 09 2021 19:13:20] Settings.load
[Sep 09 2021 19:13:20] Settings.load: Trying to load /home/user/.config/onionshare/onionshare.json
[Sep 09 2021 19:13:20] Common.get_resource_path: filename=wordlist.txt
[Sep 09 2021 19:13:20] Common.get_resource_path: filename=wordlist.txt, path=/home/user/code/onionshare/cli/onionshare_cli/resources/wordlist.txt
[Sep 09 2021 19:13:20] ModeSettings.load: creating /home/user/.config/onionshare/persistent/polish-pushpin-hydrated.json
[Sep 09 2021 19:13:20] ModeSettings.set: updating polish-pushpin-hydrated: general.title = None
[Sep 09 2021 19:13:20] ModeSettings.set: updating polish-pushpin-hydrated: general.public = False
[Sep 09 2021 19:13:20] ModeSettings.set: updating polish-pushpin-hydrated: general.autostart_timer = 0
[Sep 09 2021 19:13:20] ModeSettings.set: updating polish-pushpin-hydrated: general.autostop_timer = 0
[Sep 09 2021 19:13:20] ModeSettings.set: updating polish-pushpin-hydrated: share.autostop_sharing = True
[Sep 09 2021 19:13:20] Web.__init__: is_gui=False, mode=share
[Sep 09 2021 19:13:20] Common.get_resource_path: filename=static
[Sep 09 2021 19:13:20] Common.get_resource_path: filename=static, path=/home/user/code/onionshare/cli/onionshare_cli/resources/static
[Sep 09 2021 19:13:20] Common.get_resource_path: filename=templates
[Sep 09 2021 19:13:20] Common.get_resource_path: filename=templates, path=/home/user/code/onionshare/cli/onionshare_cli/resources/templates
[Sep 09 2021 19:13:20] Web.generate_static_url_path: new static_url_path is /static_gvvq2hplxhs2cekk665kagei6m
[Sep 09 2021 19:13:20] ShareModeWeb.init
[Sep 09 2021 19:13:20] Onion.__init__
[Sep 09 2021 19:13:20] Onion.connect
[Sep 09 2021 19:13:20] Settings.__init__
[Sep 09 2021 19:13:20] Settings.load
[Sep 09 2021 19:13:20] Settings.load: Trying to load /home/user/.config/onionshare/onionshare.json
[Sep 09 2021 19:13:20] Onion.connect: tor_data_directory_name=/home/user/.config/onionshare/tmp/tmpf3akiouy
[Sep 09 2021 19:13:20] Common.get_resource_path: filename=torrc_template
[Sep 09 2021 19:13:20] Common.get_resource_path: filename=torrc_template, path=/home/user/code/onionshare/cli/onionshare_cli/resources/torrc_template
Connecting to the Tor network: 100% - Done
[Sep 09 2021 19:13:30] Onion.connect: Connected to tor 0.4.6.7
[Sep 09 2021 19:13:30] Settings.load
[Sep 09 2021 19:13:30] Settings.load: Trying to load /home/user/.config/onionshare/onionshare.json
[Sep 09 2021 19:13:30] OnionShare.__init__
[Sep 09 2021 19:13:30] OnionShare.start_onion_service
[Sep 09 2021 19:13:30] Onion.start_onion_service: port=17616
[Sep 09 2021 19:13:30] Onion.start_onion_service: key_type=NEW, key_content=ED25519-V3
[Sep 09 2021 19:13:35] ModeSettings.set: updating polish-pushpin-hydrated: general.service_id = vucwsdmjt7szoc6pel3puqoxobiepdsowmqaq7pm7dzhembtzr2capad
[Sep 09 2021 19:13:35] ModeSettings.set: updating polish-pushpin-hydrated: onion.private_key = +HfFALM4MtrNh59ibfMtRwDCIpfpWHIcNh3boahqrHh3TkLAyQvzKTm/y53KoYKSh0VU+m9DZY7DtZuCzkHkqQ==
[Sep 09 2021 19:13:35] ModeSettings.set: updating polish-pushpin-hydrated: onion.client_auth_priv_key = G24TSNLIJX7YZM6R7P24AIGRU4N56ZFL7ENZVIDIWUEWY66YS3EQ
[Sep 09 2021 19:13:35] ModeSettings.set: updating polish-pushpin-hydrated: onion.client_auth_pub_key = GDY2EPXSS7Q3ELQJFIX2VELTVZ3QEYIGWIZ26CEDQKZJ5Y7VKI3A
Compressing files.
[Sep 09 2021 19:13:35] ShareModeWeb.init
[Sep 09 2021 19:13:35] ShareModeWeb.set_file_info_custom
[Sep 09 2021 19:13:35] ShareModeWeb.build_zipfile_list
[Sep 09 2021 19:13:35] Web.start: port=17616
* Running on http://127.0.0.1:17616/ (Press CTRL+C to quit)
Give this address and private key to the recipient:
http://vucwsdmjt7szoc6pel3puqoxobiepdsowmqaq7pm7dzhembtzr2capad.onion
Private key: G24TSNLIJX7YZM6R7P24AIGRU4N56ZFL7ENZVIDIWUEWY66YS3EQ
Press Ctrl+C to stop the server
Saját hibakeresési üzeneteket az onionshare/common.py fájlban található Common.log metódus meghívásával adhat hozzá. Például:
common.log('OnionShareGui', 'start_server', 'I ran here')
Ez hasznos lehet az OnionShare használata közben bekövetkező események láncolatának megismeréséhez, vagy bizonyos változók értékének vizsgálatához azok módosítása előtt és után.
Csak helyi mód
A Tor lassú, ezért fejlesztés közben gyakran kényelmes teljesen kihagyni az onion szolgáltatások indítását. Ezt a --local-only kapcsolóval teheti meg. Például:
$ poetry run onionshare-cli --local-only --receive
╭───────────────────────────────────────────╮
│ * ▄▄█████▄▄ * │
│ ▄████▀▀▀████▄ * │
│ ▀▀█▀ ▀██▄ │
│ * ▄█▄ ▀██▄ │
│ ▄█████▄ ███ -+- │
│ ███ ▀█████▀ │
│ ▀██▄ ▀█▀ │
│ * ▀██▄ ▄█▄▄ * │
│ * ▀████▄▄▄████▀ │
│ ▀▀█████▀▀ │
│ -+- * │
│ ▄▀▄ ▄▀▀ █ │
│ █ █ ▀ ▀▄ █ │
│ █ █ █▀▄ █ ▄▀▄ █▀▄ ▀▄ █▀▄ ▄▀▄ █▄▀ ▄█▄ │
│ ▀▄▀ █ █ █ ▀▄▀ █ █ ▄▄▀ █ █ ▀▄█ █ ▀▄▄ │
│ │
│ v2.4.1 │
│ │
│ https://onionshare.org/ │
╰───────────────────────────────────────────╯
* Running on http://127.0.0.1:17641/ (Press CTRL+C to quit)
Files sent to you appear in this folder: /home/user/OnionShare
Warning: Receive mode lets people upload files to your computer. Some files can potentially take control of your computer if you open them. Only open things from people you trust, or if you know what you are doing.
Give this address and private key to the sender:
http://127.0.0.1:17641
Private key: E2GOT5LTUTP3OAMRCRXO4GSH6VKJEUOXZQUC336SRKAHTTT5OVSA
Press Ctrl+C to stop the server
Ebben az esetben a http://127.0.0.1:17641 URL-t egy normál webböngészőben, például a Firefoxban kell megnyitnia a Tor Browser helyett. Csak helyi módban a privát kulcsra valójában nincs szükség, így figyelmen kívül hagyhatja.
Fordítások beküldése
Segítsen az OnionShare-t könnyebben használhatóvá, ismerősebbé és barátságosabbá tenni az emberek számára azzal, hogy lefordítja a Hosted Weblate oldalon. Az „OnionShare” nevet mindig latin betűkkel írja, és szükség esetén használja az „OnionShare (helyi név)” alakot.
A fordításhoz hozzon létre egy Hosted Weblate-fiókot, és kezdjen hozzá.
Javaslatok az eredeti angol szövegekhez
Előfordul, hogy az eredeti angol szövegek hibásak, vagy eltérnek az alkalmazásban és a dokumentációban.
A forrásszövegek javítását úgy javasolhatja, hogy Weblate-megjegyzésében megemlíti a @kingu felhasználót, vagy nyit egy GitHub-hibajegyet vagy pull requestet. Ez utóbbi biztosítja, hogy minden upstream fejlesztő lássa a javaslatot, és a szokásos kódellenőrzési folyamat során módosíthassa a szöveget.
A fordítások állapota
Itt látható a fordítások jelenlegi állapota. Ha olyan nyelven szeretne fordítást kezdeni, amelyen még nem indult el, kérjük, írjon a levelezőlistára: onionshare-dev@lists.riseup.net
