diff options
Diffstat (limited to 'doc/pl')
65 files changed, 4549 insertions, 0 deletions
diff --git a/doc/pl/.gitignore b/doc/pl/.gitignore new file mode 100644 index 000000000..e4d2dfa59 --- /dev/null +++ b/doc/pl/.gitignore @@ -0,0 +1,2 @@ +/gdpr.md +/SiteTOS.md diff --git a/doc/pl/AdvancedSearch.md b/doc/pl/AdvancedSearch.md new file mode 100644 index 000000000..f76ddf99e --- /dev/null +++ b/doc/pl/AdvancedSearch.md @@ -0,0 +1,52 @@ +Zaawansowane przeszukiwanie katalogu +==================================== + +Zaawansowane wyszukiwanie w katalogu jest włączone w "Trybie eksperta" na stronie Ustawienia > Dodatkowe funkcje. + +Na stronie katalogu, w widżecie "Znajdź kanały" (zazwyczaj na pasku bocznym) widoczna jest opcja "Zaawansowane". Kliknięcie jej otwiera kolejne pole wyszukiwania umożliwiające wprowadzenie żądań wyszukiwania zaawansowanego. + +Zaawansowane żądania zawierają: + +* name=xxx +[Nazwa kanału zawiera xxx] + +* address=xxx +[Adres kanału (webbie) zawiera xxx] + +* locale=xxx +[Lokalizaja (zazwyczaj 'city') zawiera xxx] + +* region=xxx +[Region (stan/terytorium) zawiera xxx] + +* postcode=xxx +[Kod pocztowy lub kod ZIP zawiera xxx] + +* country=xxx +[Nazwa kraju zawiera xxx] + +* gender=xxx +[Płeć zawiera xxx] + +* marital=xxx +[Stan cywilny zawiera xxx] + +* sexual=xxx +[Preferencje seksualne zawierają xxx] + +* keywords=xxx +[Słowa kluczowe zawierają xxx] + +Istnieje wiele powodów, dla których dopasowanie może nie zwrócić tego, czego szukasz, ponieważ wiele kanałów nie podaje szczegółowych informacji w swoim domyślnym (publicznym) profilu, a wiele z tych pól umożliwia wprowadzanie dowolnego tekstu w kilku językach - i sprawia to trudność w dokładnym dopasowaniu. Na przykład możesz uzyskać lepszy wynik, chcąc znaleźć kogoś w USA, nie za pomocą frazy `'country = u'` (bo pojawią sie też kanały z Niemiec, Bułgarii i Australii), a za pomocą fraz US, U.S.A, USA, United States, itd. + +Przyszłe wersje tego narzędzia mogą już działać lepiej. + +Żądania można łączyć ze sobą za pomocą operatorów `and`, `or` lub `and not`. + +Frazy zawierające spacje należy ujmowć w cudzysłowy. + +Przykład: + + name="charlie brown" and country=canada and not gender=female + +#include doc/macros/pl/main_footer.bb; diff --git a/doc/pl/Features.md b/doc/pl/Features.md new file mode 100644 index 000000000..d6950e367 --- /dev/null +++ b/doc/pl/Features.md @@ -0,0 +1,173 @@ +Opcje konfiguracyjne +==================== + +Po zainstalowaniu, serwis $Projectname jest wstępnie konfigurowany z domyślnymi wartościami. Z reguły, wymaga to odpowiedniego dostrojemia tak, aby konfiguracja odpowiadała zakładanym funkcjom serwisu. + +Ustawianie dodatkowych możliwości poprzez interfejs graficzny +------------------------------------------------------------- + +Domyślny interfejs $Projectname został zaprojektowany tak, aby był dobrze uporządkowany. Istnieje spora liczba dodatkowych funkcjonalności (o różnej przydatności), które można włączyć i później wykorzystywać. Można je znaleźć klikając link [Dodatkowe możliwości](admin/features) na stronie [Administracja](/admin). Są one tam prezentowane w kilku grupach. + +#### Kalendarz + +**Rozpocznij tydzień kalendarzowy w poniedziałek** + +Daje możliwość skonfigurowania kalendarza tak, aby tydzień kalendarzowy zaczynał się w poniedziałek. + +**Wybór strefy czasowej wydarzenia** + +Daje możliwość konfigurowania strefy czasowej wydarzenia w kalendarzu. + +#### Strona główna kanału + +**Wyszukaj po dacie** + +Daje możliwość wyboru wpisów według zakresów dat. + +**Chmura tagów** + +Udostępnienie osobistej chmury tagów na stronie swojego kanału. + +**Użyj trybu blog/lista** + +Pozwoduje, że komentarze są wyświetlane osobno. + +#### Połączenia + +**Filtrowanie połączeń** + +Umożliwia filtrowanie przychodzących wpisów z połączeń, na podstawie słów kluczowych lub fragnentów treści. + +#### Rozmowa + +**Reakcje emoji** + +Dodaje możliwość wstawiania reakcji emoji we wpisach. + +**Nielubienie wpisu** + +Możliwość oznaczania wpisów i komentarzy jako nielubiane. + +**Wyróżnienie wpisu** + +Możliwość oznaczania wyróżnionych wpisów wskaźnikiem gwiazdki. + +**Odpowiadanie na komentarze** + +Możliwość udzielenia odpowiedzi na wybrany komentarz. + +#### Katalog + +**Zaawansowane przeszukiwanie katalogu** + +Umożliwia tworzenie złożonych zapytań wyszukiwania w katalogu. + +#### Edytor + +**Kategorie wpisów** + +Możliwość dodawania kategorii do swoich wpisów. + +**Duże zdjęcia** + +Możliwość zamieszczania dużych miniatur zdjęć (1024px) we wpisach. Jeśli nie jest to włączone, można używać tylko małych miniatur (640 px). + +**Jeszcze więcej szyfrowania** + +Zezwala na opcjonalne pełne (e2ee) szyfrowanie treści za pomocą wspólnego tajnego klucza. +Stadardowo, prywatne wiadomości są szyfrowane podczas transportu i przechowywania. W dzisiejszych czasach to szyfrowanie może nie wystarczyć, jeśli twoja komunikacja jest wyjątkowo wrażliwa. Ta opcja umożliwia dodatkowo szyfrowanie treści "end-toend" za pomocą wspólnego tajnego klucza. Sposób, w jaki odbiorca pozna tajny klucz, zależy wyłącznie od Ciebie. Możesz podać wskazówkę, na przykład "imię pierwszego psa cioci Kloci". + +**Wyłączenie komentarzy** + +Zapewnia możliwość wyłączenia komentowania wpisu + +**Opóźnione publikowanie** + +Pozwala na publikację wpisów w późniejszym terminie + +**Wygasanie treści** + +Usuwanie wpisów, komentarzy albo prywatnych wiadomości w określonym terminie. Do edytora wpisów zostaje dodany dodatkowy przycisk, za pomoca któreg można ustawić termin wygaśnięcia publikacji. Zwykle data jest wyświetlana w formacie „rrrr-mm-dd gg: mm”, ale w języku angielskim ma się nieco większą swobodę i można używać większości rozpoznawalnych odniesień do dat, takich jak "next Thursday" czy "+1 day". W określonym terminie (podanym lub zajmującym około dziesięciu minut, w zależności od częstotliwości sprawdzania zdalnego systemu) element jest usuwany. + +**Pomijaj zduplikowane wpisy i komentarze** + +Zapobiegaj publikowaniu wpisów o identycznej treści, mających mniej niż dwie minuty między przesłaniami. + +**Automatyczne zapisywanie roboczych wpisów i komentarzy** + +Automatycznie zapisuje wersje robocze wpisów i komentarzy w lokalnej pamięci przeglądarki, aby zapobiec przypadkowej utracie kompozycji. + + +#### Zarządzanie + +**Wybór kanału poprzez nawigację** + +Zmiana kanału bezpośrednio z rozwijanego menu nawigacji. + +#### Sieć + +**Filtr wydarzeń** + +Możliwość wyświetlania tylko wydarzeń. + +**Filtr ankiet** + +Możliwość wyświetlania tylko ankiet. + +**Zapisywane wyszukiwanie** + +Możliwość zapisywania wyszukiwanych haseł do ponownego wykorzystania. + +**Zapisywane foldery** + +Możliwość umieszczania wpisów w folderach + +**Alternatywan kolejność strumienia** + +Możliwość uporządkowania strumienia według daty ostatniego wpisu, daty ostatniego komentarza lub nieprzeczytanych aktywności. + +**Filtr kontaktów** + +Możliwość wyświetlania wpisów autorstwa tylko wybranego kontaktu. + +**Filtr forów** + +Możliwość wyświetlania wpisów tylko z określonego forum. + +**Filtr wpisów osobistych** + +Filtr wpisów osobistych. + +**Użyj trybu blog/lista** + +Pozwoduje, że komentarze są wyświetlane osobno. + +#### Zdjęcia + +**Lokalizowanie zdjęć** + +Jeśli dane lokalizacji są dostępne na przesłanych zdjęciach, połącz je z mapą. + +##### Profile + +**Profile zaawansowane** + +Dodatkowe sekcje i pola wyboru profilu. Rozszerza to zakres informacji profilowych zbieranych w serwisie. Włączenie tej funkcjonalności powinno znaleźć odzwierciedlenie w dokumencie "Polityka prywatności", w której należy wymienić wszystkie rodzaje informacji osobistych zbieranych i utrzymywanych w serwisie. W większości przypadków jest to funkcjonalność nieprzydatna i nie powinno się jej włączać. + +**Import/Eksport proflilu** + +Możliwość zaimportowania lub wyeksportowania swojego profilu na inne serwisy (portale sieci Zot). Funkcjonalność ta związana jest z nomadycznością tożsamości internetowej w $Projectname. Domyślnie Twoja tożsamość "podróżuje" z Tobą, gdy przeglądasz matrycę zdalnych witryn - tam też wiedzą kim jesteś i mogą wyświetlać Ci treści, które tylko Ty widzisz. Dzięki rozszerzonemu udostępnianiu tożsamości możesz dostarczyć te informacje do dowolnej odwiedzanej witryny z poziomu swojej matrycy. + +**Wiele profili** + +Możliwość tworzenia wielu profili, które są widoczne tylko dla określonych osób lub grup. Twój profil domyślny może być widoczny dla każdego, ale wszystkie profile dodatkowe mogą zawierać inne lub dodatkowe informacje i mogą być widoczne tylko dla tych, do których jest przypisany. + +Dodatkowe ustawienia dostępne tylko z wiersza poleceń +----------------------------------------------------- + +Oprócz opcji konfiguracyjnych dostępnych w panelu administracyjnum, $Projectname zawiera wiele opcji, które są dostępne tylko z poziomu powłoki. Są to na ogół opcje uważane za zbyt niszowe, zaawansowane lub mogące być źle interpretowane przez zwykłych użytkowników. + +Ich omówienie znajduje się na stronie [Zaawanasowana konfiguracja dla administratorów](/doc/pl/hidden_configs). + + +#include doc/macros/pl/main_footer.bb; diff --git a/doc/pl/Plugins.md b/doc/pl/Plugins.md new file mode 100644 index 000000000..f3972a5e7 --- /dev/null +++ b/doc/pl/Plugins.md @@ -0,0 +1,260 @@ + +Tworzenie wtyczek (dodatków) do $Projectname +============================================ + +Przypuszczalnie chcesz, aby $Projectname zrobił coś, czego jeszcze nie robi. Jest wiele sposobów. Ale nauczmy się, jak napisać wtyczkę lub dodatek. + +W katalogu $Projectname prawdopodobnie zobaczysz podkatalog o nazwie "addon". Jeśli jeszcze go nie masz, utwórz go. + + mkdir addon + +Następnie wymyśl nazwę swojego dodatku. Prawdopodobnie masz już jakieś pojęcie o tym, co chcesz, aby robił. Na potrzeby naszego przykładu utworzymy wtyczkę o nazwie "randplace", która zapewni nieco losową lokalizację każdego z Twoich wpisów. Nazwa wtyczki będzie służyć do znajdowania funkcji, które trzeba użyć i jest częścią nazwy każdej z tychfunkcji, więc dla bezpieczeństwa używaj tylko prostych znaków tekstowych. + +Po wybraniu nazwy wtyczki, utwórz katalog wewnątz 'addon', aby przechowywać tu pliki wtyczki. + + mkdir addon/randplace + + +Teraz utwórz plik wtyczki. Musi mieć taką samą nazwę i jest to skrypt PHP, więc za pomocą swojego ulubionego edytora utwórz plik + + addon/randplace/randplace.php + +Pierwszą linią tego pliku musi być fraza + + <?php + +Następnie utworzymy blok komentarza, aby opisać wtyczkę. Jest do tego specjalny format. Używamy / * ... * / w stylu komentarza i niektórych oznaczonych linii składających się z + + /** + * + * Name: Random Place (here you can use better descriptions than you could in the filename) + * Description: Sample $Projectname plugin, Sets a random place when posting. + * Version: 1.0 + * Author: Mike Macgirvin <mike@zothub.com> + * + */ + +Te atrybuty będą widoczne dla administratora strony, gdy instaluje lub zarządza wtyczkami z panelu administracyjnego. Może być więcej autorów. W takim przypadku, po prostu dodaj kolejną linię zaczynającą się od "Autor:". + +Typowa wtyczka będzie miała co najmniej następujące funkcje: + +* pluginname_load() +* pluginname_unload() + +W naszym przypadku nazwiemy je `randplace_load()` i `randplace_unload()`, bo taka jest nazwa naszej wtyczki. Te funkcje są wywoływane za każdym razem, gdy chcemy zainicjować wtyczkę lub usunąć ją z bieżącej strony internetowej. Również jeśli wtyczka wymaga rzeczy takich jak zmiana schematu bazy danych przed uruchomieniem jej po raz pierwszy, trzeba będzie umieścić poniższe funkcje: + +* pluginname_install() +* pluginname_uninstall() + +Następnie omówimy **zaczepy**. Zaczepy (*ang. hooks*) to miejsca w kodzie $Projectname, do których można "podczepić" kod wtyczki, aby go tam wykonywać. Zwykle wykorzystuje się funkcję `pluginname_load()` do zarejestrowania "funkcji obsługi" dla potrzebnych zaczepów. Następnie, gdy zostanie wyzwolony którykolwiek z tych zaczepów, zostanie wywołany podpięty tam kod. + +Zarejestrujmy więc program obsługi zaczepów za pomocą funkcji `register_hook()`. Potrzebne są trzy argumenty. Pierwszy to nazwa zaczepu, który chcemy obsłużyć, drugi to nazwa pliku, który ma znaleźć naszą funkcję obsługi (ścieżka względem katalogu instalacyjnego $Projectname), a trzeci to nazwa funkcji. Stwórzmy więc teraz naszą funkcję `randplace_load()`. + +``` +function randplace_load() { + register_hook('post_local', 'addon/randplace/randplace.php', 'randplace_post_hook'); + + register_hook('feature_settings', 'addon/randplace/randplace.php', 'randplace_settings'); + register_hook('feature_settings_post', 'addon/randplace/randplace.php', 'randplace_settings_post'); +} +``` + +Tak więc przechwycimy trzy zdarzenia: `post_local`, które jest wywoływane, gdy w systemie lokalnym pojawia się wpis, `feature_settings`, aby ustawić pewne preferencje dla naszej wtyczki, oraz `feature_settings_post`, aby przechowywać te ustawienia. + +Następnie utworzymy funkcję unload. Jest to łatwe, ponieważ wystarczy wyrejestrować nasze zaczepy. Wymaga to dokładnie tych samych argumentów. + +``` +function randplace_unload() { + unregister_hook('post_local', 'addon/randplace/randplace.php', 'randplace_post_hook'); + unregister_hook('feature_settings', 'addon/randplace/randplace.php', 'randplace_settings'); + unregister_hook('feature_settings_post', 'addon/randplace/randplace.php', 'randplace_settings_post'); +} +``` +Zaczepy są wywoływane z dwoma argumentami. Pierwszą to zawsze $a, który jest naszą globalną strukturą aplikacji i zawiera ogromną ilość informacji o stanie przetwarzanego żądania HTTP; a także o tym kim jest przeglądający i jaki jest nasz stan logowania oraz aktualną zawartość strony internetowej, którą prawdopodobnie tworzymy. + +Drugi argument jest specyficzny dla zaczepu, który chce się wywołać. Zawiera informacje istotne dla tego konkretnego miejsca w programie i często pozwala na jego przegląd a nawet zmianę. Aby to zmienić, trzeba dodać zanak "&" do nazwy zmiennej, aby była przekazywana do funkcji przez odniesienie. W przeciwnym razie utworzona zostanie kopia i wszelkie wprowadzone zmiany zostaną utracone przy ponownym przetworzeniu zaczepu. Zwykle (ale nie zawsze) drugim argumentem jest nazwana tablica struktur danych. + +Dodajmy więc poniższy kod, aby zaimplementować nasz moduł obsługi zaczepu: + +``` +function randplace_post_hook($a, &$item) { + +/** +* +* W systemie lokalnym został wpisany jakiś element. +* Będziemy wyszukiwać określonych elementów: +* - Wpis napisany przez właściciela profilu +* - Właściciel profilu musi zezwolić na naszą wtyczkę +* +*/ + +logger('randplace invoked'); + +if(! local_channel()) /* nie zero jeśli zalogowany jest użytkownik systemu */ + return; + +if(local_channel() != $item['uid']) /* Czy ta osoba jest właścicielem wpisu? */ + return; + +if(($item['parent']) || (! is_item_normal($item))) { + /* Jeśli element ma rodzica lub nie jest „normalny”, jest to komentarz lub coś innego, a nie wpis. */ + return; +} + +/* Pobranie osobistych ustawień konfiguracyjnych */ + +$active = get_pconfig(local_channel(), 'randplace', 'enable'); + +if(! $active) + return; + /** + * + * OK, wolno nam robić swoje. + * Oto, co zamierzamy zrobić: + * załadowanie listy nazw stref czasowych i użycie jej do wygenerowania listy miast na świecie. + * Następnie wybierzemy losowo jedno z nich i umieścimy je w polu "location" wpisu. + * + */ + + $cities = array(); + $zones = timezone_identifiers_list(); + foreach($zones as $zone) { + if((strpos($zone,'/')) && (! stristr($zone,'US/')) && (! stristr($zone,'Etc/'))) + $cities[] = str_replace('_', ' ',substr($zone,strpos($zone,'/') + 1)); + } + + if(! count($cities)) + return; + $city = array_rand($cities,1); + $item['location'] = $cities[$city]; + + return; +} +``` + +Teraz dodajmy nasze funkcje do ustawień preferencji tworzenia i przechowywania. + +``` +/** +* +* Wywołanie zwrotne z funkcji ustawień wpisu. +* $post zawiera globalną tablicę $_POST. +* Upewnimy się, że mamy ważne konto użytkownika +* i że kliknięto tylko nasz własny przycisk submit +* a jeśli tak, to ustawiamy ustawienia konfiguracyjne dla tego użytkownika. +* +*/ + +function randplace_settings_post($a,$post) { + if(! local_channel()) + return; + if($_POST['randplace-submit']) + set_pconfig(local_channel(),'randplace','enable',intval($_POST['randplace'])); +} + +/** +* +* Wywoływanie z formularza ustawień funkcjonalności. +* Drugim argumentem jest w tym przypadku łańcuch, region treści HTML strony. +* Dodanie własnych informacje o ustawieniach do tego łańcucha. +* +* Aby zapewnić jednolitość stron ustawień, stosujemy następującą konwencję +* <div class="settings-block"> +* <h3>title</h3> +* .... settings html - będzie wiele elementów pływających ... +* <div class="clear"></div> <!-- klasa ogólna, która czyści wszystkie elementy pływające --> +* <input type="submit" name="pluginnname-submit" class="settings-submit" ..... /> +* </div> +*/ + +function randplace_settings(&$a,&$s) { + + if(! local_channel()) + return; + + /* Dodanie naszego arkusza stylów do strony, aby ładnie wyglądała strona ustawień */ + + head_add_css('/addon/randplace/randplace.css'); + + /* Pobranie aktualnego stan naszej zmiennej konfiguracyjnej */ + + $enabled = get_pconfig(local_channel(),'randplace','enable'); + + $checked = (($enabled) ? ' checked="checked" ' : ''); + + /* Dodaj trochę HTML do istniejącego formularza */ + + $s .= '<div class="settings-block">'; + $s .= '<h3>' . t('Randplace Settings') . '</h3>'; + $s .= '<div id="randplace-enable-wrapper">'; + $s .= '<label id="randplace-enable-label" for="randplace-checkbox">' . t('Enable Randplace Plugin') . '</label>'; + $s .= '<input id="randplace-checkbox" type="checkbox" name="randplace" value="1" ' . $checked . '/>'; + $s .= '</div><div class="clear"></div>'; + + /* dodanie przycisku przesyłania */ + + $s .= '<div class="settings-submit-wrapper" ><input type="submit" name="randplace-submit" class="settings-submit" value="' . t('Submit') . '" /></div></div>'; + +} +``` + +***Zaawansowane wtyczki*** + +Czasami zachodzi potrzeba zapewnienia jakichś nowych funkcji, których w ogóle nie ma lub których nie można zapewnić za pomocą zaczepów. W tym przypadku wtyczka może również działać jako "moduł". Moduł w naszym przypadku odnosi się do ustrukturyzowanej procedury obsługi strony internetowej, która odpowiada na podany adres URL. Wtedy wszystko, co uzyskuje dostęp do tego adresu URL, będzie obsługiwane w całości przez wtyczkę. + +Kluczem do tego jest stworzenie prostej funkcji o nazwie `pluginname_module()`, która nic nie robi. + +``` +function randplace_module() { return; } +``` + +Gdy ta funkcja już istnieje, adres URL https://twoja_witryna/randplace będzie uzyskiwał dostęp do wtyczki jako modułu. Następnie możesz zdefiniować funkcje, które są wywoływane w różnych miejscach w celu zbudowania strony internetowej, tak jak moduły w katalogu mod/. Oto typowe funkcje i kolejność ich wywoływania + +``` +modulename_init($a) // (e.g. randplace_init($a);) wywoływana jako pierwsza. + // Gdy chce się emitować json lub xml, powinno się to + // zrobić tutaj, a następnie wywołać killme(), co pozwoli + // uniknąć domyślnej akcji budowania strony internetowej. +modulename_aside($a) // często uzywana di tworzenia zawartości paska bocznego +modulename_post($a) // wywoływana za każdym razem, gdy strona jest otwierana + // za pomocą metody "post" +modulename_content($a) // wywoływana w celu wygenerowania zawartości strony centralnej. + // Ta funkcja powinna zwracać łańcuch znaków składający się + // z centralnej yteści strony. +``` + +Funkcje modułu mają dostęp do ścieżki URL tak, jakby były samodzielnymi programami w systemie operacyjnym Unix. Dla przykładu, w naszego module stwórzmy coś co działa pod adresem: + + https://yoursite/randplace/something/somewhere/whatever + +Bedzie to listę argc i argv do wykorzystania przez funkcje tego modułu + +``` +$x = argc(); $x will be 4, the number of path arguments after the sitename + +for($x = 0; $x < argc(); $x ++) + echo $x . ' ' . argv($x); + + 0 randplace + 1 something + 2 somewhere + 3 whatever +``` + +***Przenoszenie wtyczek Friendica*** + +$Projectname wykorzystuje podobną architekturę wtyczek do projektu Friendica. Mechanizmy uwierzytelniania, tożsamości i uprawnień są zupełnie inne. Wiele wtyczek Friendica można stosunkowo łatwo przenosić, zmieniając nazwy kilku funkcji i następnie zapewniając przestrzeganie modelu uprawnień. Funkcje, których nazwy wymagają zmiany, to: + +* Funkcja Friendica `pluginname_install()` to `pluginname_load()` + +* Funkcja Friendica `pluginname_uninstall()` to `pluginname_unload()` + +$Projectname ma funkcje `_install` i `_uninstall`, ale są one używane w inny sposób. + +* Funkcja zaczepu w Friendica `plugin_settings` ma nazwę `feature_settings` + +* Funkcja zaczepu Friendica `plugin_settings_post` ma nazwę `feature_settings_post` + +Zmiana tych ustawień często pozwoli na działanie wtyczki, ale proszę dokładnie sprawdzić wszystkie uprawnienia i kod identyfikacyjny, ponieważ koncepcje, które za tym stoją, są zupełnie inne w $Projectname. Wiele nazw danych strukturalnych (zwłaszcza kolumny schematu bazy danych) jest również zupełnie inna. + +#include doc/macros/main_footer.bb; diff --git a/doc/pl/Primary-Directory.md b/doc/pl/Primary-Directory.md new file mode 100644 index 000000000..55c61373d --- /dev/null +++ b/doc/pl/Primary-Directory.md @@ -0,0 +1,43 @@ +#Katalog główny# + +Domyślnie $Projectname używa katalogów dostępnych w Internecie, które funkcjonują jako kanały. + +Istnieją pewne scenariusze, w których może być potrzebny własny serwer katalogów, do którego można by podłączyć wiele portali. Ogranicza to dostęp tylko do kanałów w portalipodłączonych do tego serwera katalogowego. + +##Instrukcje dotyczące konfigurowania jednego portalu jako katalogu podstawowego dla wielu portali prywatnych.## +*** + + +* Na portalu , który będzie serwerem katalogów, otwórz plik .htconfig.php i ustaw: + + `App::$config['system']['directory_mode'] = DIRECTORY_MODE_PRIMARY;` + + + Domyślnie, opcja ta powinna już być ustawiona na **DIRECTORY_MODE_NORMAL**, więc po prostu wystarczy tylko ustawić nową wartość: **DIRECTORY_MODE_PRIMARY** + +* Następnie, na każdym portalu (w tym na serwerze katalogowym), w terminalu, przejdź do folderu z kodem $Projectname i uruchom usługę katalogową: + + `util/config system directory_realm YOURREALMNAME` + + (**YOURREALMNAME** może być dowolną nazwą dziedziny katalogowej) + + po czym: + + `util/config system realm_token THEPASSWORD` + + (**THEPASSWORD** jest hasłem dla dziedziny katalogowej) + + **UWAGA:** Trzeba użyć tej samej nazwy dziedziny i hasła dla każdego portalu + +* Na koniec, dla każdego portalu "klienckiego", uruchom (z terminala): + + `util/config system directory_server https://theaddressofyourdirectoryserver.com` + +*** +Teraz, gdy przeglądasz katalog każdego portalu, powinien on pokazywać tylko kanały, które istnieją w portalach ustawionej domeny katalogowej. Do tej pory testowałem to z dwoma portalami i wydaje się, że działa dobrze. +Kanały utworzone w każdym portalu są odzwierciedlane w katalogu głównym, a następnie w katalogu wszystkich portali klienckich + +##Problemy## +*** + +Kiedy tworzyłem pierwszy portal, był on uruchomiony i działał przez około godzinę, zanim zmieniłem go na PRIMARY_MODE, a po zmianie w katalogu nadal było kilka kanałów z całej sieci. Usunąłem je z tabeli xchan i wydaje się, że rozwiązało to problem. diff --git a/doc/pl/TermsOfService.md b/doc/pl/TermsOfService.md new file mode 100644 index 000000000..498df7998 --- /dev/null +++ b/doc/pl/TermsOfService.md @@ -0,0 +1,9 @@ +Regulamin serwisu +================= + +#include doc/pl/SiteTOS.md; + +Polityka prywatności +==================== + +#include doc/pl/gdpr.md;
\ No newline at end of file diff --git a/doc/pl/Translations.md b/doc/pl/Translations.md new file mode 100644 index 000000000..2939ce564 --- /dev/null +++ b/doc/pl/Translations.md @@ -0,0 +1,86 @@ +Tłumaczenie $Projectname +======================== + +Procedura tłumaczenia na język polski +------------------------------------- + +Tłumaczenie interfejsu użytkownika, ekranów kontekstowej pomocy oraz dokumentacji na język polski odbiega nieco od ogólnej procedury przyjetej w $Projectname. Po prostu, zrezygnowano z przygotowania pliku translacyjnego hmessages.po za pośrednictwem serwisu [Transifex][1], tak jak to jest zalecane w $Projectname i posłużono się sporządzeniem tych plików przy pomocy ogólnie dostępnych narzędzi translacyjnych przeznaczonych do tworzenia plików [gettext](https://www.gnu.org/software/gettext/) rozszerzenia .po, .mo, .pot), takich jak [poedit](https://poedit.net/) i inne. + +Trzeba podkreślić, że to odstępstwo dotyczy przygotowania pliku hmessages.po i organizacji prac nad tłumaczeniem. + +Tłumaczenie $Projectname na język polski jest obecnie wydzielone w odrębny podprojekt, utrzymywany w [repozytorium na GitHub] https://github.com/astabski/hubzilla-pl) + +Projekt ten obejmuje wszystkie pliki potrzebne do przetłumaczenia interfesju użytkownika, pomocy kontekstowej i oficjalnej dokumentacji, zawarte w następujących katalogach kodu $Projectname: + +- view/pl +- doc/context/pl +- doc/macros/pl +- doc/pl + +Projekt ten jest obecnie podstawą oficjalnego polskiego tłumaczenia $Projectname. Po każdej istotnej zmianie, osoba kierująca projektem tłumaczenia zgłasza odpowiednie żądanie PR do drzewa żródłowego $Projectname. + +### Zgłaszanie poprawek + +Jeśli chcesz zgłosić jakieś zmiany w istniejącym tekście tłumaczenia, otwórz nową sprawę na stronie https://github.com/astabski/hubzilla-pl/issues i podaj tam szczegóły proponowanych zmian. + +Możesz też dokonać poprawek w tym projekcie, zgłaszając odpowiednio przygotowane żądanie PR. + +### Nowe tłumaczenia + +Jeśli chcesz pomóc, tworząc tłumaczenia jeszcze nie przetłumaczonych dokumentów $Projectname, dołącz do projektu https://github.com/astabski/hubzilla-pl. W tym celu umieść na stronie https://github.com/astabski/hubzilla-pl/issues odpowiednią wiadomość. Otrzymasz odpowiedź z dokładną instrukcją. + +Ogólne zasady tłumaczeń obowiązujące w $Projectname +--------------------------------------------------- + +Jeśli chcesz samodzielnie przenieść swoją pracę do drzewa źródłowego $Projectname, skontaktuj się z zespołem $Projectname i zadaj pytania. + +Proces jest tłumaczenia prosty, a oprogramowanie $Projectname jest dostarczane ze wszystkimi niezbędnymi narzędziami. + +Lokalizacją przetłumaczonych plików jest w kodzie źródłowym katalog `/view/LNG-CODE/`, gdzie `LNG-CODE` jest używanym kodem języka, np. `de` dla niemieckiego albo `pl` dla polskiego. + +W przypadku szablonów wiadomości e-mail (pliki `*.tpl`) po prostu trzeba umieścić je w katalogu i gotowe. Przetłumaczone łańcuchy pochodzą z pliku `hmessages.po` z serwisu Transifex, który należy przetłumaczyć na plik PHP używany przez $Projectname. Aby to zrobić, trzeba umieścić plik w wymienionym wyżej katalogu i użyć narzędzia `po2php` z katalogu `util` w instalacji $Projectname. + +Zakładając, że chcesz przetłumaczyć polską wersję umieszczoną pliku `view/pl/hmessages.po`, wykonaj następujące czynności. + +1. Przejdź w wierszu polecenia do katalogu głównego instalacji $Projectname + +2. Wykonaj skrypt `po2php`, który jest umieszczono tłumaczenia dla pliku `hstrings.php`, który jest używany w $Projectname. + + $> php util/po2php.php view/pl/hmessages.po + + Dane wyjściowe skryptu zostaną umieszczone w `view/de/hstrings.php, bo tam + froemdoca oczekuje tego pliku, więc możesz natychmiast przetestować swoje + tłumaczenie. + +3. Odwiedź swoją stronę $Projectname, aby sprawdzić, czy nadal działa w języku, który właśnie przetłumaczyłeś. Jeśli nie, spróbuj znaleźć błąd, najprawdopodobniej PHP da ci wskazówkę w opisie błędu w `log/warnings.about`. + + W celu debugowania możesz również spróbować "uruchomić" plik za pomocą PHP. Nie powinno to dawać żadnych wyników, jeśli plik jest w porządku, ale może dać wskazówkę dotyczącą wyszukiwania błędu. + + $> php view/de/hstrings.php + +4. Zatwierdź te dwa pliki z sensownym komunikatem o zatwierdzeniu do repozytorium git, wypchnij je do rozwidlenia repozytorium $Projectname na github i wydaj żądanie ściągnięcia dla tego zatwierdzenia. + +Narzędzia +--------- + +Oprócz skryptu po2php, jest jeszcze w katalogu "util" w drzewie źródłowym $Projectname kilka narzędzi do tłumaczenia. Jeśli tylko chcesz przetłumacz $Projectname na inny język, którego nie potrzebujesz najbardziej, ale da Ci to wyobrażenie o procesie +tłumaczenia $Projectname. + +Więcej informacji można znaleźć w pliku utils/README. + +Znane problemy +-------------- + +* $Projectname używa ustawień języka przeglądarki odwiedzających, aby określić + język interfejsu użytkownika. W większości przypadków to działa, ale są pewne + znane dziwactwa. +* wczesne tłumaczenia są oparte na przekładach Friendica, jeśli znajdziesz jakieś + błędy, daj nam znać lub popraw je w Transifex. + +Linki +------ + +[1]: http://www.transifex.com/projects/p/hubzilla/ + + +#include doc/pl/macros/main_footer.bb; diff --git a/doc/pl/Widgets.md b/doc/pl/Widgets.md new file mode 100644 index 000000000..08cc42d17 --- /dev/null +++ b/doc/pl/Widgets.md @@ -0,0 +1,171 @@ +Rdzenne widżety +=============== + +Niektóre z tych widżetów ma ograniczenia, które mogą ograniczać typ strony, na której można umieszczać widżet lub mogą wymagać logowania + + +* clock - wyświetla aktualny czas + * args: military (1 or 0) - use 24 hour time as opposed to AM/PM +<br /> <br /> + +* profile - wyświetla boczny pasek profilu na stronach, które ładują profile (strony z pseudonimem w adresie URL) + +* tagcloud - wyświetla tagcloud elementów strony + + * args: count - liczba elementów do jednoczesnego wyświetlenia (domyślnie 24) +<br /> <br /> + +* collections - selektor grupy prywatności dla aktualnie zalogowanego kanału + + * args: mode - może to być "conversation", "group" albo "abook" w zależności od modułu +<br /> <br /> + +* suggestions - sugestie znajomych dla aktualnie zalogowanego kanału + +* follow - przedstawia pole tekstowe do śledzenia innego kanału + +* notes - obszar prywatnych notatek dla aktualnie zalogowanego kanału, jeśli funkcja private_notes jest włączona + +* savedsearch - wyszukiwanie sieci lub matrycy z zapisem - trzeba być zalogowanym i musi być włączona funkcjonalność savedsearch + +* filer - wybór elementów pola ze strumienia sieci lub matrycy - musi się być zalogowanym + +* archive - selektor zakresu dat dla stron sieci i kanałów + * args: 'wall' - 1 or 0, ograniczenie do wpisów ściennych lub wpisów sieciowych/matrycowych (domyślnie) +<br /> <br /> + +* fullprofile - taki sam jak obecny profil + +* categories - filtr kategorii (strona kanału) + +* tagcloud_wall - tagcloud tylko dla strony kanału + * args: 'limit' - ilość tagów do wyświetlenie (domyślnie 50) +<br /> <br /> + +* catcloud_wall - tagcloud dla kategorii stron kanału + * args: 'limit' - liczba kategorii do wyświetlenia na jednej stronie (domyślnie 50) +<br /> <br /> + +* affinity - suwak powinowactwa na stronie sieciowej, trzeba być zalogowanym + +* settings_menu - menu paska bocznego dla strony ustawień, trzeba być zalogowanym + +* mailmenu - menu paska bocznego dla strony z prywatnymi wiadomościami, trzeba sie zalogować + +* design_tools - menu narzędzi projektowych do tworzenia stron internetowych, trzeba sie zalogować + +* findpeople - narzędzia do wyszukiwania innych kanałów + +* photo_albums - wyświetla listę albumów ze zdjęciami aktualnego właściciela strony za pomocą menu wyboru + +* vcard - mini pasek boczny profilu dla osoby, którą się jest zainteresowanym (właściciel strony, cokolwiek) + +* dirsafemode - narzędzie do wyboru katalogu - tylko na stronach katalogów + +* dirsort - narzędzie do wyboru katalogu - tylko na stronach katalogów + +* dirtags - narzędzie katalogowe - tylko na stronach katalogów + +* menu_preview - wyświetlanie podgląd menu - tylko na stronach edycji menu + +* chatroom_list - lista czatów dla właściciela strony + +* bookmarkedchats - lista zakładek do czatów zebranych na tej stronie dla obecnego obserwatora + +* suggestedchats - "ciekawe" czaty wybrane dla obecnego obserwatora + +* item - wyświetla pojedynczą stronę internetową zgodnie z argumentem mid lub title + * args: + * channel_id - kanał, do którego należy treść, domyślnie jest to profile_uid + * mid - message_id strony do wyświetlenia (musi być to strona internetowa a nie element konersacji) + * title - argument title w adresie URL strony internetowej (musi zawierać tutuł lub mid) +<br /> <br /> + +* photo - wyświetla pojedyncze zdjęcie + * args: + * url - adres URL zdjęcia, musu zawierać schemat http lub https + * zrl - uwierzytelniony link zid + * style - łańcuch stylu CSS +<br /> <br /> + +* cover_photo - wyświetla zdjęcie okładkowe dla wybranego kanału + * args: + * channel_id - zastosowany kanał, domyślnie jest to profile_uid + * style - łańcuch stylu CSS (domyślnie jest dynamicznie ustawiane na szerokość regionu) +<br /> <br /> + + +* photo_rand - wyświetla losowe zdjęcie z jednego z albumów fotograficznych. Honorowane są uprawnienie dostępu do zdjęć + * args: + * album - nazwa albumu (bardzo gorąco zalecane, jeśli ma się dużo zdjęć) + * scale - zazwyczaj 0 (oryginalna wielkość), 1 (1024px), 2, (640px) lub 3 (320px) + * style - łańcuch stylu CSS + * channel_id - jeśli nie Twój +<br /> <br /> + +* random_block - wyświetlić losowy element blokowy z kolekcji narzędzi do projektowania stron internetowych. Honorowane są uprawnienia dostępu. + * args: + * contains - zwraca tylko bloki, które zawierają łańcuch cotains w nazwie bloku + * channel_id - jeśłi nie Twój +<br /> <br /> + +* tasklist - podać listę zadań lub spraw do załatwienia dla aktualnie zalogowanego kanału. + * args: + * all - jeśłi nie 0, to wyświetla ukończone zadania. +<br /> <br /> + +* forums - podać listę połączonych forów publicznych z niewidocznymi liczbami dla aktualnie zalogowanego kanału. +<br /> <br /> + +* activity - podać listę autorów nieprzeczytanych treści sieciowych dla aktualnie zalogowanego kanału. + +* album - udostępnia widget zawierający pełny album ze zdjęciami z albumów należących do właściciela strony; może być zbyt duży, aby wyświetlić go w regionie paska bocznego, więc najlepiej jest zaimplementować to jako widżet obszaru treści. + * args: + * album - nazwa albumu + * title - opcjonalny tytuł, używana jest nazwa albumu, jeśli nie jest dostęþna +<br /> <br /> + + +Tworzenie własnych widżetów +=========================== + +### Widżety oparty na klasie + +Aby utworzyć widżet oparty, na przykład, na klasie o nazwie "slugfish", utwórz plik o następującej zawartości: + +```` +<?php + +namespace Zotlabs\Widget; + + +class Slugfish { + + function widget($args) { + + ... Wstaw tutaj kod widżetu. + ... Funkcja ta zwraca łańcuch, który jest treścią HTML widżetu. + ... $args to nazwa tablicy, która przekazuje sowolne zmienne [var] z edytora układu + ... Na przykład [widget=slugfish][var=count]3[/var][/widget] wypełni $args tak: + ... [ 'count' => 3 ] + + } + +```` +Wynikowy plik można umieścić w widget/Slugfish/Slugfish.php lub Zotlabs/SiteWidgets/Slugfish.php. Można go również połączyć z repozytorium git za pomocą pliku util/add_widget_repo. + +### Tradycyjny widget oparty na funkcjach + +Jeśli chcesz mieć widżet o nazwie, na przykład, "slugfish", utwórz `widget/widget_slugfish.php` zawierający + + + <?php + + function widget_slugfish($args) { + + .. wstaw tu kod widżetu. Zobacz powyższe informacje o widżetach opartych na klasie, aby uzyskać szczegółowe informacje. + + } + + +#include doc/macros/main_footer.bb; diff --git a/doc/pl/about/about.bb b/doc/pl/about/about.bb new file mode 100644 index 000000000..ae596deff --- /dev/null +++ b/doc/pl/about/about.bb @@ -0,0 +1,184 @@ +[h3]Co to jest $Projectname?[/h3] +$Projectname Hubzilla to bezpłatny i otwartoźródłowy zestaw aplikacji i usług internetowych, które można wdrożyć na własnym serwerze internetowym jako samodzielny portal społecznościowy, zwanym też "hubem". Portal ten może łączyć się z innymi portalami tego typu, tworząc sfederowaną sieć społecznościową. +$Projectname zapewnia użytkownikom zaawansowaną komunikację, tożsamości i usługę kontroli dostępu, które bezproblemowo współpracują w różnych domenach i niezależnych serwisach internetowych. +$Projectname pozwala użytkownikom komunikować się i publikować treści w swoich "kanałach" z możliwością bardzo szczegółowej kontroli dostępu. Kanały są zabezpieczonymi kryptograficznie tożsamościami internetowymi, zapewniającymi uwierzytelnianie użytkowników niezależnie od portali na których są hostowane. To rewolucyjne uwolnienie tożsamości inernetowej z poszczególnych serwerów i domen jest nazywane "tożsamością nomadyczną" i jest oparte na protokole Zot - nowej strukturze zdecentralizowanej kontroli dostępu ze szczegółowymi, rozszerzalnymi uprawnieniami. +Z praktycznego punktu widzenia członków danego portalu, korzystających z oprogramowania $Projectname, oferuje ono szereg znanych, zintegrowanych aplikacji i usług internetowych, w tym: +[ul] +[li]wątki dyskusyjne w sieciach społecznościowych[/li] +[li]przechowywanie plików w chmurze[/li] +[li]kalendarz i kontakty (z obsługą CalDAV i CardDAV)[/li] +[li]hosting stron internetowych z systemem zarządzania treścią[/li] +[li]wiki[/li] +[li]i dużo więcej ...[/li][/ul] +Chociaż wszystkie te aplikacje i usługi można znaleźć w innych pakietach oprogramowania, tylko $Projectname pozwala ustawić uprawnienia dla grup i osób, [b]które mogą nawet nie mieć kont na Twoim portalu[/b]! W typowych aplikacjach internetowych, jeśli chcesz udostępniać rzeczy prywatnie w Internecie, osoby, którym udostępniasz dane, muszą mieć konta na serwerze, na którym znajdują się Twoje dane; w przeciwnym razie serwer nie może uwierzytelniać odwiedzających witrynę, aby wiedzieć, czy przyznać im dostęp. $Projectname rozwiązuje ten problem za pomocą zaawansowanego systemu zdalnego uwierzytelniania, który weryfikuje tożsamość odwiedzających, wykorzystując techniki obejmujące kryptografię klucza publicznego. +Dzięki oferowanym aplikacjom, $Projectname świetnie się nadaje do budowy platformy komunikacyjno-publikacyjnej o charkterze społecznościowym dla realnych grup społecznych, takich jak rodziny, lokalne grupy, organizacje społeczne, środowiska szkolne, wspólnoty mieszkańców czy wspólnoty religijne. + +[h3]Stos programów[/h3] +Pakiet oprogramowania $Projectname jest stosunkowo standardową aplikacją serwerową napisaną głównie w PHP i MySQL, wymagającą niewiele więcej niż [url=https://framagit.org/$Projectname/core/blob/master/install/INSTALL.txt]serwera WWW, bazy danych zgodnej z MySQL i środowiska wykonawczego PHP[/url]. System został zaprojektowany tak, aby był łatwy do zainstalowania przez osoby z podstawowymi umiejętnościami administrowania witryną, na typowych platformach współdzielonego hostingu, z uwzglednieniem szerokiej gamy sprzętu komputerowego. Można go również łatwo rozszerzyć za pomocą wtyczek i motywów oraz innych narzędzi zewnętrznych. + +[h3]Słownik[/h3] +[dl terms="b"] +[*= portal, hub ([i]ang. hub[/i])] Instancja oprogramowania $Projectname działająca na standardowym serwerze WWW + +[*= sieć Zot, sieć ([i]w oryginale ang., grid[/i])] Globalna sieć portali, które wymieniają między sobą informacje za pomocą protokołu Zot. Nie są to tylko portale oparte na $Projectname, ale wszystkie portale implementujące protokół Zot. + +[*= kanał ([i]ang. channel[/i])] Forma organizacji treści i techniczny odpowiednik tożsamości. Kanał może mieć formę osobistej witryny internetowej, bloga, forum i innych znanych form publikowania treści. Kanały mogą łączyć się z innymi kanałami w celu udostępniania informacji z możliwością ustawiania bardzo szczegółowych uprawnień dostępu. + +[*= klon ([i]ang. clone[/i])] Kanały mogą mieć klony innych na innych niezależnych portalach. Komunikacja współdzielona z kanałem jest synchronizowana między klonami kanału, co umożliwia kanałowi wysyłanie i odbieranie wiadomości oraz dostęp do współdzielonych treści z wielu portali. Zapewnia to odporność na awarie sieci i sprzętu, które mogą stanowić poważny problem w przypadku serwerów WWW utrzymywanych na prywatnych serwerach w hostingu współdzielonym lub o ograniczonych zasobach. Klonowanie umożliwia też całkowite przeniesienie kanału z jednego portalu na drugi, z zabraniem wszystkich danych i połączeń. Zobacz "tożsamość nomadyczna". + +[*= konto ([i]ang. account[/i])] Umowny rejestr zawierajacy dane rejestracyjne i ewentualnie inne dane użytkownika serwisu internetowego (portalu), ściśle związane z umową jaką zwiera użytkownik z operatorem (właścicielem) serwisu o świadczenie usług drogą internetową. Posiadanie konta umożliwia użytkownikowi korzystanie z usług serwisu. Nie jest to pojęcie specyficzne dla platformy Hubzilla ale ma tu znaczenie węższe i należy go odróżniać od profilu lub tożsamości użytkownika. W Hubzilla, użytkownik (w ramach swojego konta) może mieć wiele tożsamości i te tożsamości utrzymywać na wielu odrębnych portalach w sieci Zot, w sposób zsynchronizowany. Na tych portalach użytkownik musi mieć odrębne konta. + +[*= tożsamość nomadyczna ([i]ang. nomadic identity[/i])] Możliwość uwierzytelniania i łatwej migracji tożsamości i powiązanych danych użytkownika pomiędzy niezależnymi portalami i domenami internetowymi. Tożsamość nomadyczna zapewnia prawdziwą własność tożsamości internetowej i suwerenność danych użytkownika oraz przenoszalność usług. + +[*= [url=[baseurl]/help/developer/zot_protocol]Protokół Zot[/url]] Nowy protokół, oparty na JSON, do wdrażania bezpiecznej, zdecentralizowanej komunikacji i usług. Różni się od wielu innych protokołów komunikacyjnych, budując komunikację na podstawie zdecentralizowanej struktury tożsamości i uwierzytelniania. Składnik uwierzytelniania jest koncepcyjnie podobny do OpenID, ale jest odizolowany od tożsamości opartej na DNS. Tam, gdzie to możliwe, zdalne uwierzytelnianie jest ciche i niewidoczne. Zapewnia to mechanizm kontroli dostępu rozproszonego na skalę sieci WWW, który jest dyskretny. +[/dl] + +[h3]Możliwości[/h3] +Ten rozdział zawiera listę niektórych podstawowych funkcjonalności platformy $Projectname, które są dołączone do oficjalnej wersji. $Projectname to platforma o dużych możliwościach rozbudowy, więc więcej funkcji i możliwości można dodać za pomocą dodatkowych motywów i wtyczek. + +[h4]Suwak zaprzyjaźnienia (Affinity Slider)[/h4] +Dodając połączenia w serwisie $Projectname, członkowie mają możliwość przypisania poziomów "zaprzyjażnienia" ([i]ang. affinity[/i]), czyli określenia, jak bliska jest twoja przyjaźń z osobą reprezentowaną przez nowe połączenia. Na przykład, dodając osobę, której blog obserwujesz, możesz przypisać jej kanałowi poziom zaprzyjaźnienia "Znajomi". + +Z drugiej strony, dodając kanał przyjaciela, możesz go umieścić na poziomie zaprzyjaźnienia "Przyjaciele". + +Gdy to zrobisz, narzędzie "Suwak zaprzyjaźnienia", które zwykle pojawia się u góry głównej strony kanału (matrycy), dostosowuje zawartość strony tak, aby zawierała elementy z żądanego zakresu zaprzyjaźnienia. Kanały spoza tego zakresu nie będą wyświetlane, chyba że dostosujesz suwak, aby to uwzględnić. + +Suwak zaprzyjażnienia umożliwia natychmiastowe filtrowanie dużych ilości treści, pogrupowanych według poziomów zaprzyjaźnienia. + +[h4]Filtrowanie połączeń (Connection Filtering)[/h4] +Masz możliwość precyzyjnego kontrolowania tego, co pojawia się w Twoim strumieniu za pomocą opcjonalnego "Filtra połączeń" ([i]ang. Connection Filter[/i]). Po włączeniu Edytor połączeń zapewnia dane wejściowe do wybierania kryteriów, które należy dopasować, aby uwzględnić lub wykluczyć określony wpis z określonego kanału. Gdy wpis został dopuszczony, wszystkie komentarze do tego wpisu są dozwolone, niezależnie od tego, czy spełniają kryteria wyboru. Możesz wybrać słowa, które jeśli są obecne, blokują wpis lub zapewniają, że zostanie uwzględniony w Twoim strumieniu. Wyrażenia regularne mogą być używane do jeszcze dokładniejszej kontroli, a także hasztagów, a nawet wykrytego języka wpisu. + +[h4]Listy kontrolne dostępu (Access Control Lists - ACL)[/h4] +Udostępniając zawartość, członkowie mają możliwość ograniczenia tego, kto widzi zawartość. Klikając na kłódkę pod polem udostępniania, można wybrać odbiorców wpisu, klikając ich nazwy. + +Po wysłaniu, wiadomość będzie widoczna tylko dla nadawcy i wybranych odbiorców. Innymi słowami, wiadomość nie pojawi się na jakichkolwiek publicznych ścianach. + +Listy kontroli dostępu mogą być stosowane do treści i wpisów, zdjęć, wydarzeń, stron internetowych, pokojów rozmów i plików. + +[h4]Jednokrotne uwierzytelnianie (Single Sign-on)[/h4] +Listy kontroli dostępu działają dla wszystkich kanałów w siatce dzięki naszej unikalnej technologii pojedynczego logowania. Większość linków wewnętrznych zapewnia token tożsamości, który można zweryfikować w innych witrynach $Projectname i wykorzystać do kontrolowania dostępu do prywatnych zasobów. Logujesz się raz do swojego centrum domowego. Następnie uwierzytelnianie we wszystkich zasobach serwisu $Projectname jest "magiczne". + +[h4]Magazyn plików z obsługą WebDAV[/h4] +Pliki można przesyłać do osobistego obszaru przechowywania za pomocą narzędzi systemu operacyjnego (w większości przypadków metodą przeciągnij i upuść). Możesz chronić te pliki za pomocą list kontroli dostępu dla dowolnej kombinacji członków Hubzilli (w tym niektórych członków sieci stron trzecich) lub upublicznić je. + +[h4]Albumy fotograficzne[/h4] +Przechowuj zdjęcia w albumach. Wszystkie Twoje zdjęcia mogą być chronione listami kontroli dostępu. + +[h4]Kalendarze zdarzeń[/h4] +Twórz zdarzenia i zadania oraz zarządzaj nimi, które mogą być również chronione za pomocą list kontroli dostępu. Wydarzenia można importować i eksportować do innego oprogramowania przy użyciu standardowego formatu vcalendar lub iCal i udostępniać w wpisuch innym osobom. Wydarzenia urodzinowe są automatycznie dodawane od znajomych i konwertowane na właściwą strefę czasową, dzięki czemu będziesz dokładnie wiedzieć, kiedy mają miejsce urodziny - bez względu na to, gdzie się znajdujesz na świecie w stosunku do osoby urodzonej w dniu urodzin. Wydarzenia są zwykle tworzone za pomocą liczników obecności, dzięki czemu Twoi znajomi i kontakty mogą natychmiast [url=https://pl.wikipedia.org/wiki/RSVP_(skr%C3%B3towiec]RSVP[/url]. + +[h4]Czaty[/h4] +Możesz utworzyć dowolną liczbę osobistych czatów i zezwolić na dostęp za pośrednictwem list kontroli dostępu. Są one zazwyczaj bezpieczniejsze niż XMPP, IRC i inne rodzaje przesyłania wiadomości błyskawicznych, chociaż zezwalamy również na korzystanie z tych innych usług za pośrednictwem wtyczek. + +[h4]Tworzenie stron internetowych[/h4] +$Projectname ma wiele narzędzi do tworzenia stron internetowych systemu CMS, w tym do edycji układu, menu, bloków, widżetów i regionów strony i treści. Dostęp do wszystkich tych elementów można kontrolować, tak aby powstałe strony były prywatne dla zamierzonych odbiorców. + +[h4]Aplikacje[/h4] +Aplikacje mogą być tworzone i rozpowszechniane przez członków. Różnią się one od tradycyjnych aplikacji typu "vendor lockin", ponieważ są całkowicie kontrolowane przez autora - który może zapewnić kontrolę dostępu do stron aplikacji docelowej i odpowiednio pobierać opłaty za ten dostęp. Większość aplikacji w Hubzilli jest bezpłatna i mogą być łatwo tworzone przez osoby bez umiejętności programowania. + +[h4]Układ stron (Layout)[/h4] +Układ strony jest oparty na języku opisu o nazwie Comanche. $Projectname sama jest napisana w układach Comanche, które możesz zmieniać. Pozwala to na poziom dostosowania, którego zwykle nie znajdziesz w tak zwanych "środowiskach wielu użytkowników". + +[h4]Zakładki (Bookmarks)[/h4] +Udostępniaj i zapisuj albo zarządzaj zakładkami z linków podanych na czacie. + +[h4]Szyfrowanie wiadomości prywatnych i kwestie prywatności[/h4] +Prywatna poczta jest przechowywana w ukrytym formacie. Chociaż nie jest to "kuloodporne", zwykle zapobiega przypadkowemu podsłuchiwaniu przez administratora witryny lub usługodawcę internetowego. + +Każdy kanał serwisu $Projectname ma swój własny unikalny zestaw prywatnych i powiązanych publicznych kluczy RSA 4096-bitowych, generowanych podczas pierwszego tworzenia kanałów. Służy do ochrony przesyłanych prywatnych wiadomości i wpisów. + +Ponadto wiadomości mogą być tworzone przy użyciu "szyfrowania end-to-end", którego nie mogą odczytać operatorzy serwisów $Projectname, dostawcy usług internetowych ani nikt, kto nie zna hasła. + +Wiadomości publiczne na ogół nie są szyfrowane podczas przesyłania ani przechowywania. + +Prywatne wiadomości mogą zostać wycofane po wysłaniu, chociaż nie ma gwarancji, że odbiorca ich jeszcze nie przeczytał. + +Wpisy i wiadomości mogą być tworzone z datą wygaśnięcia, po którym zostaną usunięte lub usunięte ze strony odbiorcy. + +[h4]Federalizacja usług (Service Federation)[/h4] +Oprócz dodatkowych łączników między wpisami z różnych alternatywnych sieci, istnieje natywna obsługa importu treści z kanałów RSS i Atom i wykorzystywania jej do tworzenia specjalnych kanałów. Dostępne są również wtyczki do komunikacji z innymi sieciami za pomocą protokołów Diaspora i GNU-Social (OStatus). Sieci te nie obsługują tożsamości nomadycznej ani kontroli dostępu między domenami. Jednak podstawowa komunikacja jest obsługiwana: do i z Diaspora, Friendica, GNU-Social, Mastodon i innych dostawców, którzy używają tych protokołów. + +Istnieje również eksperymentalna obsługa uwierzytelniania OpenID, której można używać na listach kontroli dostępu. To jest jeszcze w trakcie tworzenia, ale poeksperymentować można. Twój portal $Projectname może być używany jako dostawca OpenID do uwierzytelniania członków w zewnętrznych usługach korzystających z tej technologii. + +Kanały mogą mieć uprawnienia, aby stać się "kanałami pochodnymi", w przypadku gdy dwa lub więcej istniejących kanałów łączy się, tworząc nowy kanał tematyczny. + +[h4]Grupy prywatności (Privacy Group)[/h4] +Nasza implementacja grup prywatności jest podobna do "kręgów" w Google i "aspektów" w Diasporze. Pozwala to na filtrowanie przychodzącego strumienia według wybranych grup i automatyczne ustawianie wychodzącej listy kontroli dostępu tylko na te z tej grupy prywatności podczas publikowania. Możesz to zmienić w dowolnym momencie (przed wysłaniem wpisu). + + +[h4]Usługi katalogowe (Directory Services)[/h4] +Zapewniamy łatwy dostęp do katalogu członków i udostępniamy zdecentralizowane narzędzia, które mogą dostarczać "sugestie" znajomych. Katalogi to zwykłe serwisy $Projectname, które zdecydowały się zaakceptować rolę serwera katalogowego. Wymaga to więcej zasobów niż większość typowych serwisów, więc nie jest to ustawienie domyślne. Katalogi są synchronizowane i dublowane, dzięki czemu wszystkie zawierają aktualne informacje o całej sieci (z zastrzeżeniem normalnych opóźnień propagacji). Więcej na ten temat znajdziesz w artykule [Konfiguracja katalogu](/help/pl/directories). + +[h4]TLS/SSL[/h4] +W przypadku portali $Projectname, które używają TLS/SSL, komunikacja między klientem a serwerem jest szyfrowana za pomocą protokołu TLS/SSL. Biorąc pod uwagę niedawno ujawnione w mediach fakty dotyczące powszechnego, globalnego nadzoru i obchodzenia szyfrowania przez NSA i GCHQ, uzasadnione jest założenie, że komunikacja chroniona przez HTTPS może być zagrożona na różne sposoby. W konsekwencji prywatna komunikacja jest szyfrowana na wyższym poziomie przed wysłaniem na zewnątrz. + +[h4]Konfiguracja kanałów[/h4] +Podczas tworzenia kanału wybierana jest rola, która stosuje szereg wstępnie skonfigurowanych ustawień zabezpieczeń i prywatności. Są one wybierane z uwzględnieniem najlepszych praktyk, aby zachować prywatność na żądanym poziomie. + +W przypadku wybrania "własnej" roli prywatności każdy kanał umożliwia precyzyjne ustawienie uprawnień dla różnych aspektów komunikacji. Na przykład, pod nagłówkiem "Ustawienia bezpieczeństwa i prywatności", każdy aspekt w lewej części strony ma sześć (6) możliwych opcji przeglądania i dostępu, które można wybrać, klikając menu rozwijane. Istnieje również wiele innych ustawień prywatności, które możesz edytować. Dostępne opcje: + + - Nikt oprócz ciebie. + - Tylko ci, którym wyraźnie zezwalasz. + - Ktoś w twojej książce adresowej. + - Każdy na tej stronie. + - Każdy w tej sieci. + - Każdy jest uwierzytelniony. + - Każdy w internecie. + + +[h4]Prywatne i publiczne fora[/h4] +Fora to zazwyczaj kanały, w których może uczestniczyć wielu autorów. Obecnie istnieją dwa mechanizmy publikowania wpisów na forach: + + - wpisy na całą ścianę (ang. wall-to-wall) i + - mechanizm tagów forowych @mention. + +Fora mogą być tworzone przez każdego i używane w dowolnym celu. Katalog zawiera opcję wyszukiwania forów publicznych. Fora prywatne mogą być publikowane tylko dla członków i często tylko przez nich widoczne. + +[h4]Klonowanie tożsamości[/h4] +Kanały platformy $Projectname nazywane są [i]tożsamościami nomadycznymi[/i], ponieważ tożsamość członka (jego profil i związany z nim kanał) nie jest powiązana z portalem, w którym tożsamość została pierwotnie utworzona. Na przykład, kiedy tworzysz konto na Facebooku lub Gmailu, jest ono ściśle powiązane z tymi usługami - mie możesz używać tych usług poza Facebook.com czy Gmail.com. Z drugiej strony załóżmy, że masz konto na serwisie Hubzillahub.com i w ramach tego konta utworzyłeś kanał o nazwie [code]jacek@Hubzillahub.com[/code]. Możesz sklonować go do innego portalu Hubzilla, wybierając tę samą lub inną nazwę, np. [code]blogJacka@SomeHubzillahub.info[/code]. + +Z drugiej strony załóżmy, że utworzyłeś tożsamość $Projectname o nazwie [code]tina@$Projectnamehub.com[/code]. Możesz sklonować ją do innego portalu $Projectname, wybierając tę samą lub inną nazwę, np. [code]liveForever@Some$ProjectnameHub.info[/code]. + +Oba kanały są teraz zsynchronizowane, co oznacza, że wszystkie Twoje kontakty i preferencje zostaną zduplikowane na klonie. Nie ma znaczenia, czy wyślesz wpis z pierwotnego centrum, czy z nowego. Wpisy będą dublowane na obu kontach. + +To dość rewolucyjna funkcja, jeśli weźmiemy pod uwagę kilka scenariuszy: + + - Co się stanie, jeśli portal, na którym oparta jest tożsamość, nagle przestanie działać? Bez sklonowania tożsamości członek tego portalu nie będzie mógł się komunikować, dopóki portal nie wróci do trybu online (bez wątpienia wielu z Was widziało i przeklęło "Fail Whale" na Twitterze). Dzięki klonowaniu wystarczy zalogować się na sklonowane konto, a życie toczy się normalnie. + + - Administrator twojego portalu nie może już sobie pozwolić na opłacanie swojego bezpłatnego i publicznego portalu $Projectname. Zapowiada, że portal zostanie zamknięty za dwa tygodnie. Dzięki temu masz wystarczająco dużo czasu na sklonowanie swojej tożsamośc i zachowanie relacji, znajomych i treści z zamykanego serwisu $Projectname. + + - A jeśli Twoja tożsamość podlega rządowej cenzurze? Operator Twojego portalu może zostać zmuszony do usunięcia Twojego konta wraz z wszelkimi tożsamościami i powiązanymi danymi. Dzięki klonowaniu, $Projectname stawia opór cenzurze. Możesz mieć setki klonów, jeśli chcesz, wszystkie nazwane inaczej i istniejące w wielu różnych portalach, rozrzuconych po Internecie. + +$Projectname oferuje interesujące nowe możliwości prywatności. Więcej informacji można znaleźć na stronie "Najlepsze praktyki w komunikacji prywatnej". +Obowiązują pewne zastrzeżenia. Aby uzyskać pełne wyjaśnienie klonowania tożsamości, przeczytaj stronę "JAK SKLONOWAĆ SWOJĄ TOŻSAMOŚĆ". + +[h4]Wiele profili[/h4] +Można utworzyć dowolną liczbę profili zawierających różne informacje, które mogą być widoczne dla niektórych Twoich kontaktów i znajomych. Profil "domyślny" może być widoczny dla każdego i zawierać tylko ograniczone informacje o Tobie. Natomiast dodatkowe profile, dostępne dla wybranych grup lub osób, mogą juz zawierać dodatkowe informacje. Oznacza to, że profil (i przypisane mu treści), który widzą Twoi znajomi pijący piwo, może być inny niż to, co widzą Twoi współpracownicy, a także zupełnie inny niż to, co jest widoczne dla ogółu internautów. + +[h4]Kopia zapasowa konta[/h4] + +$Projectname oferuje prosty sposób wykonywania kopii zapasowej konta za jednym kliknięciem, z której możesz pobrać pełną kopię zapasową swoich profili. Kopie zapasowe można następnie wykorzystać do sklonowania lub przywrócenia profilu. + +[h4]Usuwanie konta[/h4] +Konta można natychmiast usunąć, klikając link. Otóż to. Wszystkie powiązane treści są następnie usuwane z sieci (w tym wpisy i wszelkie inne treści utworzone przez usunięty profil). W zależności od liczby posiadanych połączeń proces usuwania zdalnej zawartości może zająć trochę czasu, ale zaplanowany jest tak szybko, jak to możliwe. + +[h4]Usuwanie treści[/h4] +Wszelkie treści utworzone w Hubzilli pozostają pod kontrolą członka (lub kanału), który je pierwotnie utworzył. W dowolnym momencie członek może usunąć wiadomość lub zakres wiadomości. Proces usuwania zapewnia, że treść zostanie usunięta, niezależnie od tego, czy została opublikowana w głównym (macierzystym) portalu kanału, czy w innym portalu, gdzie kanał został zdalnie uwierzytelniony za pośrednictwem Zot (protokół komunikacji i uwierzytelniania $Projectname). + +[h4]Media[/h4] +Podobnie jak każdy inny nowoczesny system blogowania, sieć społecznościowa lub usługa mikroblogowania, $Projectname obsługuje przesyłanie plików, osadzanie filmów, łączenie stron internetowych. + +[h4]Podgląd i edycja[/h4] +Wpisy i komentarze można przeglądać przed wysłaniem i edytować po wysłaniu. + +[h4]Głosowanie i konsensus[/h4] +Wpisy mogą być przekształcane w elementy "konsensusu", które pozwalają czytelnikom oferować opinie, które są zestawiane w liczniki "zgadzam się", "nie zgadzam się" i "wstrzymuję się". Pozwala to ocenić zainteresowanie pomysłami i tworzyć nieformalne ankiety. + +[h4]Rozszerzanie $Projectname[/h4] + +$Projectname może zostać rozszerzona na wiele sposobów, poprzez dostosowanie witryny, personalizację, ustawienia opcji, motywy i dodatki - wtyczki. + +[h4]API[/h4] + +Interfejs API jest dostępny do użytku przez usługi stron trzecich. Wtyczka zapewnia również podstawową implementację interfejsu API Twittera (dla którego istnieją setki narzędzi innych firm). Dostęp można zapewnić za pomocą loginu i hasła lub protokołu OAuth, a klient może zarejestrować aplikacje OAuth. + diff --git a/doc/pl/about/about_hub.bb b/doc/pl/about/about_hub.bb new file mode 100644 index 000000000..ce9aac5fd --- /dev/null +++ b/doc/pl/about/about_hub.bb @@ -0,0 +1,7 @@ +[h3]Informacja o tym portalu[/h3] +[list][*][url=[baseurl]/siteinfo]Informacja o portalu[/url] +[*][url=[baseurl]/siteinfo/json]Informacja o portalu (format JSON)[/url][/list] +[h3]Regulamin serwisu[/h3] +[list][*][url=[baseurl]/help/TermsOfService]Warunki świadczenia usług[/url][/list] +#include doc/pl/SiteTOS.md; + diff --git a/doc/pl/about/project.bb b/doc/pl/about/project.bb new file mode 100644 index 000000000..57f7b320d --- /dev/null +++ b/doc/pl/about/project.bb @@ -0,0 +1,180 @@ +[h3]Zarządzanie projektem $Projectname[/h3] +Zarządzanie $Projectname odnosi się do zarządzania tym projektem a zwłaszcza do tego jak rozwiązywane są konflikty w tym projekcie. + +[h4]Zarządzanie społecznością[/h4] +Projekt jest utrzymywany przez społeczność $Projectname i decyzje podejmowane są w ramach tej społeczności. Struktura zarządzania ciągle się rozwija. Do czasu zakończenia tworzenia tej struktury, decyzje są podejmowane w następującej kolejności: + +[ol] +[*] Opóźniony konsensus + +Jeśli propozycja projektowa zostanie złożona na jednym z forów zarządzania projektem i nie ma poważnych zastrzeżeń w "rozsądnym" terminie od daty złożenia wniosku (zazwyczaj zapewniamy wszystkim zainteresowanym 2-3 dni na ustosunkowanie się), nie musi być głosowania aby decyzja została podjęta i propozyzja zostanie uznana za zatwierdzoną przez aklamację. Po tym czasie mogą zostać zgłoszone jakieś zastrzeżenie i oabawy, ale jeśli zostaną one uwzględnione podczas dyskusji i przedstawione zostaną rozwiązania, nadal będą uznawane za zatwierdzone. + + +[*] Weto + +Starsi deweloperzy, z długim stażem w projekcie, mogą zawetować każdą decyzję. Decyzja może zostać podjęta dopiero po usunięciu weta lub przedłożeniu alternatywnej propozycji. + + +[*] Głosowanie społeczności + +Decyzja, która nie ma wyraźnego mandatu lub wyraźnego konsensusu, ale nie jest zawetowana, może zostać podjęta po głosowaniu spółeczności. Obecnie jest to zwykłe popularne głosowanie na jednym z odpowiednich forów społeczności. W tej chwili o wyniku decyduje głosowanie powszechne. Może się to zmienić w przyszłości, jeśli społeczność przyjmie model zarządzania "przez radę". Ten dokument zostanie wówczas zaktualizowany o zaktualizowane zasady zarządzania. +[/ol] + +Głosowanie społeczności nie zawsze zapewnia powszechnie akceptowany wynik i może polaryzować społeczność, wytwarzając frakcje (stąd przyczyna, dla której rozważane są inne modele). Jeśli propozycja została przegłosowana, nadal jest kilka rozwiązań, które można zrobić, aby propozycja została przesłana ponownie z nieco innymi parametrami (przekształcenie na dodatek, przekształcenie na opcjonalną funkcję, która jest domyślnie wyłączona itp.). Jeśli zainteresowanie funkcją jest duże, a głosowanie jest "bliskie", może to wywołać wiele złych uczuć wśród przegranych wyborców. W przypadku tak bliskich głosów [b] zdecydowanie zaleca się [/ b], aby wnioskodawca podjął kroki w celu rozwiązania wszelkich zgłoszonych wątpliwości i ponownie przedłożył. + +[h4]Polityka prywatności[/h4] + +Q: Kto może widzieć moją treść? + +A: Domyślnie KAŻDY w Internecie, chyba że ograniczysz do niej dostęp. $Projectname pozwala wybrać żądany poziom prywatności. Treści podlegające ograniczeniom NIE będą widoczne dla "sieci szpiegowskich" i reklamodawców. Będą chroniona przed podsłuchem przez osoby postronne - najlepiej jak potrafimy. Administratorzy portali z wystarczającymi umiejętnościami i cierpliwością MOGĄ być w stanie podsłuchiwać niektóre prywatne wiadomości, ale muszą dołożyć starań, aby to zrobić. W $Projectname istnieją tryby prywatności, które są nawet odporne na podsłuchiwanie przez wykwalifikowanych i zdeterminowanych administratorów portali. + +Q: Czy moje treści mogą zostać ocenzurowane? + +A: Z założenie, $Projectname (jako sieć) NIE MOŻE cenzurować twoich treści. Administratorzy serwerów i portali podlegają lokalnemu prawodawstwu i MOGĄ usunąć budzące zastrzeżenia treści ze swojego portalu. Każdy może zostać administratorem portalu, w tym Ty. Dlatego publikuj treści, które w innym przypadku mogłyby zostać ocenzurowane. Nadal MOŻESZ podlegać lokalnemu prawodawstwu. + +[h5]Definicje[/h5] + +**$Projectname** + +Inaczej nazywane "platformą $Projectname", jest oprogramowaniem do budowania portali internetowych zdolnych do tworzenia zdecenralizowanych sieci społecznościowych. Poszczególne portale są węzłami tej sieci (ang. *hubs*) i mogą łączyć się z innymi federacyjnymi sieciami społecznościowymi, tworząc razem globalną sieć społecznosciową, zwaną "Fediverse". + +**portal, hub** (ang. *hub*) + +Implementacja $Projectname na serwerze internetowym. Stanowi serwis internetowy sieci WWW. Jest on dostarczany przez **operatora portalu** i może być publiczny lub prywatny, płatnu lub bezpłatny. + +*administrator portalu** + +Osoba wyznaczona przez operator portalu do zarządzania portalem. + +[h5]Polityki[/h5] + +**Informacja publiczna** + +Wszelkie informacje lub cokolwiek zamieszczone przez Ciebie w $Projectname MOŻE być publiczne lub widoczne dla każdego w Internecie. W miarę możliwości $Projectname pozwala chronić zawartość i ograniczać, kto może ją oglądać. + +Twoje zdjęcie profilowe, nazwa Twojego kanału i lokalizacja (adres URL lub adres sieciowy) Twojego kanału są widoczne dla każdego w internecie, a kontrola prywatności nie wpływa na wyświetlanie tych elementów. + +MOŻESZ dodatkowo podać inne informacje profilowe. Wszelkie informacje, które podajesz w swoim „domyślnym” lub **publicznym profilu** MOGĄ zostać przesłane do innych portali w $Projectname i dodatkowo MOGĄ zostać wyświetlone w katalogu kanałów. Możesz ograniczyć wyświetlanie tych informacji profilowych. Może być ograniczone tylko do członków twojego portalu lub tylko połączeń (znajomych) lub innych ograniczonych grup widzów, zgodnie z twoim życzeniem. Jeśli chcesz, aby Twój profil był ograniczony, musisz ustawić odpowiednie ustawienia prywatności lub po prostu NIE podawać dodatkowych informacji. + +**Treść** + +Treści, które udostępniasz (wpisy ze statusami, zdjęcia, pliki itp.) Należą do Ciebie. $Projectname domyślnie publikuje treści w sposób otwarty i widoczny dla każdego w internecie (PUBLICZNY). MOŻESZ kontrolować to w ustawieniach swojego kanału i ograniczyć domyślne uprawnienia lub MOŻESZ ograniczyć widoczność każdego pojedynczego opublikowanego elementu oddzielnie (PRYWATNE). Programiści $Projectname zapewnią, że ograniczone treści będą widoczne TYLKO dla osób z listy ograniczeń - najlepiej jak potrafią. + +Treści (zwłaszcza wpisy statusowe), które udostępniasz innym sieciom lub które udostępniłeś komukolwiek w Internecie (PUBLICZNE), nie mogą być łatwo cofnięte po ich opublikowaniu. MOGĄ być udostępniane innym sieciom i udostępniane za pośrednictwem kanałów RSS / Atom. Może być również rozpowszechniany na innych stronach $ Projectname. MOŻE pojawiać się w innych sieciach i witrynach internetowych oraz być widoczny w wyszukiwarkach internetowych. Jeśli nie chcesz tego domyślnego zachowania, dostosuj ustawienia swojego kanału i ogranicz listę osób, które mogą oglądać Twoje treści. + +**Komentarze i wpisy na forach** + +Komentarze do wpisów stworzonych przez innych oraz wpisy oznaczone jako wpisy na forum należą do Ciebie jako twórcy (autora), ale ich dystrybucja nie jest pod Twoją bezpośrednią kontrolą i zrzekasz się NIEKTÓRYCH praw do tych elementów. Te wpisy i komentarze MOGĄ być ponownie rozpowszechniane wśród innych i MOGĄ być widoczne dla każdego w internecie. W przypadku komentarzy, twórca "pierwszej wiadomości" w wątku (rozmowy), na który odpowiadasz, kontroluje dystrybucję wszystkich komentarzy i odpowiedzi na tę wiadomość. Jest on "właścicielem" i dlatego ma określone prawa w odniesieniu do całej rozmowy (w tym wszystkich zawartych w niej komentarzy). Nadal możesz edytować lub usuwać komentarz, ale właściciel rozmowy ma również prawa do edytowania, usuwania, ponownej dystrybucji i tworzenia kopii zapasowych i przywracania dowolnej lub całej zawartości rozmowy. + +**Informacja prywatna** + +Programiści $Projectname zapewnią, że każda dostarczona przez Ciebie zawartość oznaczona jako PRYWATNA będzie chroniona przed podsłuchem - najlepiej jak potrafią. Zawartość kanału prywatnego MOŻE być widoczna w bazie danych każdego zaangażowanego administratora portalu, ale prywatne wiadomości są ukrywane w bazie danych. To ostatnie oznacza, że jest to bardzo trudne, ale NIE niemożliwe, aby te treści były widoczne dla administratora portalu. Treść kanału prywatnego i wiadomości prywatne są również usuwane z powiadomień e-mail. Pełne szyfrowanie jest oferowane jako funkcja opcjonalna i NIE MOŻE być widoczne, nawet dla zdeterminowanego administratora. + +[h5]Prywatność tożsamości[/h5] + +Prywatność dla Twojej tożsamości to kolejny aspekt. Ponieważ masz zdecentralizowaną tożsamość w $Projectname, Twoja prywatność wykracza poza Twój portal. Jeśli chcesz mieć pełną kontrolę nad swoją prywatnością i bezpieczeństwem, powinieneś uruchomić własny portal na dedykowanym serwerze. Dla wielu osób jest to skomplikowane ale może poszerzyć ich możliwości techniczne. Wymieńmy więc kilka środków ostrożności, które możesz podjąć, aby zapewnić sobie jak największą prywatność. + +Zdecentralizowana tożsamość ma wiele zalet i daje wiele interesujących funkcji, ale powinieneś być świadomy faktu, że Twoja tożsamość jest znana innym portalom w sieci $Projectname. Jedną z tych zalet jest to, że inne kanały mogą udostępniać dostosowane treści i umożliwiać oglądanie prywatnych rzeczy (takich jak prywatne zdjęcia, które inni chcą Ci udostępnić). Z tego powodu te kanały muszą wiedzieć, kim jesteś. Ale rozumiemy, że czasami te inne kanały wiedzą od Ciebie więcej, niż byś sobie tego życzył. Na przykład wtyczka Visage, która może poinformować właściciela kanału o ostatniej wizycie w jego profilu. Możesz łatwo zrezygnować z tego niskiego poziomu i uważamy, że jest to nieszkodliwe śledzenie. + +* Możesz włączyć [url=http://donottrack.us/]Do Not Track (DNT)[/url] w swojej przeglądarce internetowej. Szanujemy tą nową propozycję polityki prywatności. Wszystkie nowoczesne przeglądarki obsługują DNT. Znajdziesz to w ustawieniach prywatności swojej przeglądarki lub możesz zapoznać się z instrukcją przeglądarki internetowej. Nie wpłynie to na funkcjonalność $Projectname. To ustawienie jest prawdopodobnie wystarczające dla większości ludzi. + +* Możesz [url=[baseurl]/settings]wyłączyć publikację[/url] swojego kanału w naszym katalogu kanałów. Jeśli chcesz, aby ludzie mogli znaleźć Twój kanał, podaj im adres swojego kanału. Uważamy, że jest to dobra wskazówka, że wolisz dodatkową prywatność i automatycznie włączasz opcję "Nie śledź", jeśli tak jest. + +* Możesz mieć zablokowany portal. Oznacza to, że wszystkie kanały i treści na tym portalu nie są publiczne ani widoczne dla świata zewnętrznego. To jest coś, co może zrobić tylko administrator portalu. Szanujemy to również i automatycznie włączamy opcję "Nie śledź:, jeśli jest ustawiona. + +[h5]Cenzura[/h5] + +$Projectname to globalna sieć obejmująca wszystkie religie i kultury. Nie oznacza to, że każdy członek sieci czuje się tak samo jak Ty w spornych kwestiach, a niektórzy ludzie mogą MOCNO sprzeciwić się publikowanym przez Ciebie treściom. Ogólnie rzecz biorąc, jeśli chcesz opublikować coś, o czym wiesz, że nie jest powszechnie akceptowane, najlepszym rozwiązaniem jest ograniczenie odbiorców za pomocą kontroli prywatności do małego kręgu znajomych. + +$Projectname jako dostawca sieci nie może cenzurować zawartości. Jednak administratorzy portali MOGĄ cenzurować wszelkie treści, które pojawiają się w ich portalu, aby zachować zgodność z lokalnym prawem, a nawet osobistym osądem. Ich decyzja jest ostateczna. Jeśli masz problemy z jakimkolwiek administratorem portali, możesz przenieść swoje konto i wpisy do innej witryny, która jest bardziej zgodna z Twoimi oczekiwaniami. Sprawdzaj (okresowo) [Warunki świadczenia usług](help/TermsOfService) swojego portalu, aby poznać wszelkie zasady lub wytyczne. Jeśli Twoje treści składają się z materiałów, które są nielegalne lub mogą powodować problemy, MOCNO zachęcamy do hostowania własnych (zostań administratorem własnego portalu). Mimo to. możesz stwierdzić, że Twoje treści są zablokowane w niektórych portalach, ale $Projectname jako sieć nie może w ogóle zablokować ich publikowania. + +W $Projectname ZALECA się, aby administratorzy portali zapewnili okres karencji wynoszący 1-2 dni między ostrzeżeniem właściciela konta o treści, którą należy usunąć, a fizycznym usunięciem lub wyłączeniem konta. Dzięki temu właściciel treści będzie mógł wyeksportować metadane swojego kanału i zaimportować je do innej witryny. W rzadkich przypadkach treść może mieć taki charakter, że uzasadnia natychmiastowe zamknięcie konta. To jest decyzja właściciela portalu, a nie decyzja $Projectname. + +Jeśli zazwyczaj i regularnie publikujesz treści dla dorosłych lub obraźliwe, MOCNO zachęcamy do oznaczenia swojego konta jako „NSFW” (Not Safe For Work). Zapobiegnie to wyświetlaniu Twojego zdjęcia profilowego w katalogu, z wyjątkiem przeglądających, którzy zdecydowali się wyłączyć „tryb bezpieczny”. Jeśli administratorzy katalogu uznają Twoje zdjęcie profilowe za nieobyczajne lub obraźliwe, administrator katalogu MOŻE oznaczyć Twoje zdjęcie profilowe jako NSFW. Obecnie nie ma oficjalnego mechanizmu do zakwestionowania lub cofnięcia tej decyzji, dlatego NALEŻY oznaczyć własne konto jako NSFW, jeśli może być nieodpowiednie dla ogółu odbiorców. + +[h3]Podziękowania[/h3] + +Dziękujemy wszystkim, którzy przez lata pomagali i przyczynili się do powstania projektu i jego poprzednikom. Możliwe, że przegapiliśmy Twoje imię, ale jest to niezamierzone. Dziękujemy również społeczności i jej członkom za dostarczenie cennego wkładu, bez którego cały ten wysiłek byłby bez znaczenia. + +Warto również docenić wkład i rozwiązania problemów, które powstały w wyniku dyskusji między członkami i twórcami innych, nieco powiązanych i konkurujących ze sobą projektów; +nawet jeśli mieliśmy sporadyczne nieporozumienia. + +[list] +[li]Mike Macgirvin[/li] +[li]Fabio Comuni[/li] +[li]Simon L'nu[/li] +[li]marijus[/li] +[li]Tobias Diekershoff[/li] +[li]fabrixxm[/li] +[li]tommy tomson[/li] +[li]Simon[/li] +[li]zottel[/li] +[li]Christian Vogeley[/li] +[li]jeroenpraat[/li] +[li]Michael Vogel[/li] +[li]erik[/li] +[li]Zach Prezkuta[/li] +[li]Paolo T[/li] +[li]Michael Meer[/li] +[li]Michael[/li] +[li]Abinoam P. Marques Jr[/li] +[li]Tobias Hößl[/li] +[li]Alexander Kampmann[/li] +[li]Olaf Conradi[/li] +[li]Paolo Tacconi[/li] +[li]tobiasd[/li] +[li]Devlon Duthie[/li] +[li]Zvi ben Yaakov (a.k.a rdc)[/li] +[li]Alexandre Hannud Abdo[/li] +[li]Olivier Migeot[/li] +[li]Chris Case[/li] +[li]Klaus Weidenbach[/li] +[li]Michael Johnston[/li] +[li]olivierm[/li] +[li]Vasudev Kamath[/li] +[li]pixelroot[/li] +[li]Max Weller[/li] +[li]duthied[/li] +[li]Martin Schmitt[/li] +[li]Sebastian Egbers[/li] +[li]Erkan Yilmaz[/li] +[li]sasiflo[/li] +[li]Stefan Parviainen[/li] +[li]Haakon Meland Eriksen[/li] +[li]Oliver Hartmann (23n)[/li] +[li]Erik Lundin[/li] +[li]habeascodice[/li] +[li]sirius[/li] +[li]Charles[/li] +[li]Tony Baldwin[/li] +[li]Hauke Zuehl[/li] +[li]Keith Fernie[/li] +[li]Anne Walk[/li] +[li]toclimb[/li] +[li]Daniel Frank[/li] +[li]Matthew Exon[/li] +[li]Michal Supler[/li] +[li]Tobias Luther[/li] +[li]U-SOUND\mike[/li] +[li]mrjive[/li] +[li]nostupidzone[/li] +[li]tonnerkiller[/li] +[li]Antoine G[/li] +[li]Christian Drechsler[/li] +[li]Ludovic Grossard[/li] +[li]RedmatrixCanada[/li] +[li]Stanislav Lechev [0xAF][/li] +[li]aweiher[/li] +[li]bufalo1973[/li] +[li]dsp1986[/li] +[li]felixgilles[/li] +[li]ike[/li] +[li]maase2[/li] +[li]mycocham[/li] +[li]ndurchx[/li] +[li]pafcu[/li] +[li]Simó Albert i Beltran[/li] +[li]Manuel Reva[/li] +[li]Manuel Jiménez Friaza[/li] +[li]Gustav Wall aka "neue medienordnung plus"[/li] +[/list] diff --git a/doc/pl/accounts_profiles_channels_basics.bb b/doc/pl/accounts_profiles_channels_basics.bb new file mode 100644 index 000000000..224bfd6df --- /dev/null +++ b/doc/pl/accounts_profiles_channels_basics.bb @@ -0,0 +1,20 @@ +[size=large][b]Konta, profile i kanały[/b][/size] + +Po zarejestrowaniu [i]konta[/i], trzeba również utworzyć [i]profil[/i] i [i]kanał[/i]. Na wielu portalach $Projectname Twój kanał jest zakładany automatycznie, ale to i tak wymaga Twojej interwencji. Profil będzie wymagał uzupełnienia lub poprawienia danych, podobnie jak automatycznie założony kanał. + +[b]Konto[/b] +Na portalu $Projectname masz [i]jedno[/i] konto. Składa się z Twojego adresu e-mail i hasła. Za pomocą swojego konta uzyskujesz dostęp do swojego profilu i kanału. + +[i]Pomyśl o swoim koncie jak o sposobie uwierzytelniania na którymkolwiek portalu $Projectname. Pozwala ono na takie rzeczy, jak tworzenie profili i kanałów, za pomocą których możesz łączyć się z innymi osobami.[/i] + +[b]Profil[/b] +Z pewnością masz już doświadczenie w rejestrowaniu się w jakichś usługach internetowych, takich jak fora lub społeczności internetowe. We wszystkich przypadkach trzeba było podać pewne informacje o sobie, takie jak data urodzenia, kraj, wiek i upodobania. [observer=1]Jeśli chcesz, możesz zobaczyć swój profil tutaj: [baseurl]/profile/[observer.webname] i edytować go, klikając ikonę ołówka obok swojego awatara.[/observer] +W przeciwieństwie do innych usług, $Projectname oferuje Ci możliwość tworzenia [i]wielu profilii[/i]. W ten sposób możesz rozróżnić profile skierowane specjalnie do wszystkich (Twój profil publiczny), współpracowników, rodziny czy partnera. +[i]Potraktuj swój profil jako podstawowe informacje o sobie, które przekazujesz innym osobom.[/i] + +[b]Kanał[/b] +Podczas rejestracji tworzysz swój pierwszy [i]kanał[/i]. Zostaje on przyporządkowany do domyślnego profilu. Podobnie jak w przypadku profili, możesz mieć kilka kanałów (jeśli parametry konta to dopuszczają). Na początku może to być nieco zagmatwane, ale wyjaśnijmy to. Masz już jeden kanał. Możesz używać go publicznie, aby komunikować się z osobami w codziennym życiu. Ale być może, jesteś zapalonym czytelnikiem książek i wielu ludzi się tym nudzi. Otwierasz więc [i]drugi kanał[/i] tylko dla miłośników książek, na którym wszyscy mogą rozmawiać o książkach tyle, ile chcesz. Oczywiście jest to nowy strumień wpisów, z nowym profilem (... lub nowymi profilami ...) i zupełnie innymi kontaktami. Niektóre połączenia mogą istnieć w obu kanałach, ale będą takie, które dotyczą tylko jednego z nich. Ty sam po prostu przełączasz się między nimi, tak jak w prawdziwym życiu, kiedy rozmawiasz z ludźmi, których spotykasz na ulicy lub z osobami, które spotykasz specjalnie, aby porozmawiać o książkach. Możesz nawet połączyć się ze sobą lub lepiej: z innym kanałem. :) +[i]Pomyśl o kanale jako o różnych przestrzeniach poświęconych różnym tematom, w których spotykasz się z różnymi ludźmi.[/i] + +#include doc/macros/pl/main_footer.bb; + diff --git a/doc/pl/acl_dialog_post.html b/doc/pl/acl_dialog_post.html new file mode 100644 index 000000000..6ac1c2154 --- /dev/null +++ b/doc/pl/acl_dialog_post.html @@ -0,0 +1,42 @@ +<!-- Wpisy sieciowe i kanałowe nie mogą zmienić swoich uprawnień po wysłaniu, +ten plik pomocy jest dla tego rodzaju elementów. Pliki, zdjęcia itp. powinny +korzystać z innego pliku pomocy. --> + +<h2>Uprawnienia dla wpisu</h2> + +<p> +Okno dialogowe uprawnień pozwala wybrać, które kanały albo grupy prywatności +mogą widzieć wpis. Można też wybrać, komu wyraźnie odmawia się dostępu. Załóżmy +na przykład, że planujesz niespodziewane przyjęcie dla znajomego. Możesz wysłać +zaproszenie do wszystkich w swojej grupie <b>Znajomi</b> <i>oprócz </i> znajomego, +któremu chcesz zrobić niespodziankę. W tym przypadku ustawiasz "Pokaż" grupie +<b>Znajomi</b>, ale ""Nie pokazuj" tej jednej osobie. +</p> + +<dl class="text-info dl-terms-large dl-horizontal"> +<dt style="width: 3em;">Wskazówka!</dt> +<dd style="margin-left: 4em;"> +Kolor obramowania każdego kanału wskazuje, czy ten kanał — lub jedną z grup, +do której należy — będzie mieć dostęp do wpisu. Kolor obramowania będzie +również wskazywać, kiedy kanał lub grupa, do której należy, została wyraźnie +ustawiona na "Nie pokazuj". +</dd> +</dl> + +<h3>Dlaczego nie mogę edytować uprawnień do wpisu po jego zapisaniu?</h3> + +<p> +Możesz zmienić uprawnienia do swoich plików, zdjęć i polubień, ale nie do wpisów +po ich zapisaniu. Główny powód jest taki, że po zapisaniu wpisu jest on rozpowszechniany +na kanale publicznym, a stamtąd na inne serwery Hubzilla lub tym, którym chciałeś +go pokazać. Tak jak nie możesz odzyskać czegoś, co przekazałeś innej osobie, nie +możesz zmienić uprawnień do wpisów Hubzilli. Musielibyśmy śledzić wszędzie, gdzie +trafia Twój wpis, śledzić wszystkich, którym pozwoliłeś go zobaczyć, a następnie +śledzić, od kogo go usunąć. +</p> +<p> +Jeśli wpis jest publiczny, jest to jeszcze trudniejsze, ponieważ Hubzilla jest siecią +globalną i nie ma możliwości śledzenia wpisu, nie mówiąc już o jego niezawodnym +odzyskaniu. Inne sieci, które mogą otrzymać Twój wpis, nie mają niezawodnego sposobu +na usunięcie lub odzyskanie wpisu. +</p> diff --git a/doc/pl/addons.bb b/doc/pl/addons.bb new file mode 100644 index 000000000..5c1690d44 --- /dev/null +++ b/doc/pl/addons.bb @@ -0,0 +1,117 @@ +[h3]Wtyczki/Dodatki[/h3] +[list=1] +[*] abcjsplugin - tworzenie zapisów nutowych w swoich wpisach +[*] adultphotoflag - zapobiega wyświetlaniu zdjęć NSFW w albumach publicznych +[*] authchoose - wysyłanie potwierdzenia tożsamości tylko do witryn znajomych +[*] b2tbtn - zapewnia przycisk powodujący przejście bezpośrednio na górę strony, jeśli przewinie się dużo treści dół okna +[*] bbmath - możliwość używania skomplikowanych wyrażeń matematycznych w swoich wpisach +[*] bookmarker - zamienianie #^ w linkach zakładek we wpisach +[*] buglink - umieszcza ikonę zgłaszania błędów w lewym dolnym rogu każdej strony +[*] calc - kalkulator naukowy +[*] chess - interaktywne gry w szachy z uwzględnieniem tożsamości międzydomenowej +[*] chords - generowanie wykresów palcowania i alternatyw dla każdego znanego akordu gitarowego +[*] custom_home - ustawianie własnej strony jako strony początkowej portalu +[*] diaspora - emulator protokołu Diaspora +[*] dirstats - wyświetlanie interesujących statystyk generowanych przez serwer katalogowy +[*] docs - alternatywne strony dokumentacji +[*] donate - dostarcza stronę dofinansowania +[*] dreamhost - zapewnia bardziej niezawodną usługę na hostingu współdzielonym Dreamhost +[*] dwpost - krzyżowe wpisy do Dreamwidth +[*] emojione - zezwala na uzywanie emojis jako emotikonów +[*] extcron - stosowanie zewnętrznej usługi cron do uruchamiania zaplanowanych zadań portalu +[*] firefox - dostarcza link do zainstalowania API Sharing Firefoxa +[*] flattrwidget - dostarcza przyciski "Flattr Us" +[*] flip - tworzenie odwróconego tekstu +[*] fortunate - wyświetla losowy cytat (plik cookie fortune). Wymaga skonfigurowania serwera fortune. +[*] friendica - protokół Friendica (DFRN). W tworzeniu. +[*] frphotos - importowanie albumów fotograficznych z Friendica +[*] gnusoc - protokół GNU-Social (OStatus). W tworzeniu. +[*] hexit - narzędzie do konwersji szesnastkowej +[*] hilite - umożliwia podświetlanie bloków kodu, specyficzne dla języka programowania, zawartych we wpisach +[*] hubwall - wysyłanie wiadomosci e-mail administratora na wszystkie konta w portalu +[*] ijpost - krzyżówe wpisy do Insanejournal +[*] irc - połączenie z czatami IRC +[*] jappixmini - czat XMPP +[*] js_upload - przesyłanie jednocześnie wiele zdjęć do albumów fotograficznych +[*] keepout - zapobiega prawie całkowicie korzystaniu z witryny bez zalogowania się, bardziej restrykcyjne niż ustawienie "blokuj publiczne" +[*] ldapauth - logowanie przez konto LDAP lub domenę Windows Active Directory +[*] libertree - publikowanie w Libertree +[*] likebanner - tworzenie obrazu banera "polub nas na red#matrix" +[*] ljpost - publikowanie w LiveJournal +[*] logrot - narzędzie rotowania plik dziennika zdarzeń +[*] mahjongg - gra w chińskie puzzle +[*] mailhost - umożliwienie wyboru jednego kanału dla otrzymywania powiadomień e-mail, gdy używa się wiele sklonowanych kanałów +[*] mailtest - interfejs do testowania systemu wysyłania poczty +[*] metatag - dostarcza strony przyjazne SEO +[*] mayan_places - ustawia pole lokalizacji na losowe miasto w świecie Majów +[*] morechoice - dodatkowe wybór płci i preferencji seksualnych dla profili (nie jest to bezpieczne) +[*] moremoods - dodatkowe opcje nastroju (mood) +[*] morepokes - dodatkowe opcje szturchania (poke) (nie są bezpieczne) +[*] msgfooter - podawanie formuły prawniczej lub innego tekstu w każdym wychodzącym wpisie +[*] noembed - używanie noembed.com jako dodatku do natywnej funkcjonalności oembed w $Projectname (obecnie nie działa) +[*] nofed - zapobiega "federacji" wpisów w kanale, utrzymuje całą interakcję na stronie właściciela kanału +[*] nsabait - dodawaj do swoich wpisów losowe hashtagi związane z terroryzmem +[*] nsfw - bardzo polecana wtyczka do zwijania wpisów z nieodpowiednimi treściami +[*] openclipatar - wybór zdjęcia profilowego spośród setek obrazów bez tantiem +[*] openid - uwierzytelnianie OpenID i serwer OpenID. Twój adres URL OpenID to [observer.baseurl]/id/[observer.webname] +[*] opensearch - umożliwienie swojej witrynie stania się dostawcą wyszukiwania w przeglądarce +[*] openstreetmap - renderowanie lokalizacji i mapy za pomocą OpenStreetMap +[*] pageheader - wyświetlanie tekstu u góry na każdej stronie serwisu +[*] phpmailer - alternatywny system dostarczania poczty z większą konfigurowalnością +[*] piwik - analityka witryn internetowych typu open source +[*] planets - ustawianie pola lokalizacji na losową planetę z Gwiezdnych Wojen +[*] pong - klasyczna gra w ponga +[*] pubcrawl - emulator protokołu ActivityPub +[*] pubsubhubbub - protokół PuSH dla zoptymalizowanego dostarczania wiadomości do subskrybentów (wymagany przez protokół GNU-Social) +[*] pumpio - publikowanie w Pump.io +[*] qrator - generowanie obrazów kodu QR +[*] rainbowtag - wyświetlanie chmury tagów i kategorii w kolorach +[*] randpost - bot wpis/odpowiedz oparty i wymagający fortunate +[*] redfiles - import magazynu plików z redmatrix +[*] redphotos - import albumów fotograficznych z redmatrix +[*] redred - wpisy krzyzowe do innych kanałów Red Matrix lun Hubzilla +[*] rendezvous - grupowe śledzenie lokalizacji +[*] rtof - publikowanie w Friendica +[*] sendzid - dodawanie parametróe uwierzytelniających "zid" do wszystkich linków wychodzących, nie tylko linków w sieci +[*] skeleton - przykładowa wtyczka pokazująca sposób tworzenia wtyczek +[*] smiley_pack - rozszerzenie wbudowanej obsługi buziek (emotikonów) +[*] smileybutton - zapewnia selektor buźki w oknie wpisu +[*] startpage - umowżliwia ustawienie przekierowania do preferowanej osobistej strony po zalogowaniu +[*] statistics - generator statystyk Diaspora +[*] statusnet - wpisy krzyżówe do GNU-social i StatusNet [zrl=[baseurl]/help/addons_gnusocial]Posting To Gnu Social[/zrl] +[*] std_embeds - umożłiwia niefiltrowane osadzanie dla popularnych dostawców strumieni, takich jak youtube, vimeo i soundcloud +[*] superblock - bardzo zalecane - całkowite blokowanie obraźliwuch kanałów w swoim strumieniu +[*] testdrive - zmienia portal w witrynę testową z kontami, które wygasają po okresie próbnym +[*] tictac - 3D tic-tac-toe +[*] torch - aplikacja podświetlania (flashlight) +[*] tour - prezentacja funkcji dla nowych członków +[*] tripleaes - wtyczka demonstracyjna zapewniająca niestandardowe algorytmy szyfrowania +[*] twitter - publikowanie w Twitter +[*] twitter_api - API kompatybilne z Twitter i Statusnet +[*] upload_limits - odkrywa, jakie ustawienia serwera (jest ich kilka) mogą powodować niepowodzenie przesyłania dużych zdjęć +[*] visage - pokaż odwiedzającym swój kanał +[*] webmention - przetwarzanie stron internetowych +[*] wholikesme - dostarcza stronę wyświetlającą listę kontaktów, które najbardziej "polubiły" Twoje wpisy +[*] webRTC - użycie zewnętrznego serwera (mayfirst.org) do negocjowania połączeń webRTC +[*] wppost - publikowanie w WordPress (lub w innych serwisach stosujących XMLRPC Wordpress) +[*] xmpp - XMPP czat oparty na converse.js +[/list] + +[h3]Repozytoria dodatków[/h3] + +[b]Zdecydowanie zalecamy[/b], aby autorzy dodatków publikowali (przesyłali) je do repozytorium dodatków projektu. Ma to kilka zalet. Programiści projektów mogą łatwo naprawić luki w zabezpieczeniach i wprowadzać zmiany, aby dostosować się do ostatnich zmian w kodzie podstawowym. Dodatki dostarczane w repozytoriach innych firm są uważane za niezaufane. Jeśli podstawowy kod projektu zmieni się w niekompatybilny sposób, może nie być innej alternatywy niż fizyczne usunięcie lub zmiana nazw plików dodatków, aby ponownie uruchomić witrynę. Często tylko autor wtyczki / dodatku może pomóc Ci odzyskać kontrolę nad Twoją witryną, a programiści projektów nie są w stanie Ci pomóc; ponieważ z definicji konfiguracja Twojej witryny została zmodyfikowana w sposób, którego nie możemy łatwo przetestować ani zweryfikować. + +Z tych powodów [b]zdecydowanie zalecamy[/b], aby NIE instalować dodatków z repozytoriów innych firm. + +Zdajemy sobie również sprawę, że niektórzy programiści wolą pracować samodzielnie i nie chcą z różnych powodów, aby ich kod był mieszany z repozytorium projektu. Ci programiści mogą ułatwić rozwiązywanie problemów i debugowanie, udostępniając plik README w odpowiednim repozytorium kodu, w którym opisano proces przesyłania poprawek i poprawek błędów. Zaleca się również, aby te projekty zapewniały zarówno gałąź "dev" (rozwój), jak i "master" (produkcja), która śledzi bieżące gałęzie projektu o tych nazwach. Dzieje się tak, ponieważ dev i master często nie są kompatybilne z punktu widzenia interfejsów bibliotek. Zdecydowanie zaleca się również, aby wersje repozytorium były oznaczone i przeniesione do przodu w ciągu 24 godzin od wydania projektu. Jest to poważna niedogodność dla wszystkich zaangażowanych osób i może powodować przestoje w zakładach produkcyjnych podczas przeprowadzania tego procesu; co jest jeszcze jednym powodem, dla którego [b]zdecydowanie zalecamy[/b], aby dodatki były przesyłane do repozytorium dodatków projektu i aby NIE instalować takich dodatków innych firm. + + +[url=https://framagit.org/hubzilla/addons]https://framagit.org/hubzilla/addons[/url] Główne repozytorium dodatków projektu. + +[url=https://github.com/23n/red-addons]https://github.com/23n/red-addons[/url] Repozytorium Olivera (mayan_places i flip) + + + +#include doc/macros/main_footer.bb; + + diff --git a/doc/pl/addons_gnusocial.bb b/doc/pl/addons_gnusocial.bb new file mode 100644 index 000000000..4f227cfc6 --- /dev/null +++ b/doc/pl/addons_gnusocial.bb @@ -0,0 +1,64 @@ +[b]Jak przesyłać wpisy do instancji GNUsocial[/b] + +Zacznij od instancji GNUSocial, w której masz swoje konto. + +W instancji GNUSocial przejdź do Ustawienia > Połączenia. W prawej kolumnie, w sekcji "Programiści", kliknij link "Zarejestruj aplikację kliencką OAuth, która ma być używana z tym wystąpieniem StatusNet". Ten link można znaleźć w Twojej instancji tutaj: + +https://yourgnusocialinstance.org/settings/oauthapps + +Następnie kliknij łącze "Zarejestruj nową aplikację". Pojawi się nowy formularz zgłoszeniowy. Oto, co należy zrobić na każdym polu. + +Ikona. Pobierz ikonę $Projectname znajdującą się pod tym linkiem, po zapisaniu jej na swoim komputerze: + +https://framagit.org/hubzilla/core/blob/master/images/rm-32.png + +Nazwa. Nadaj aplikacji odpowiednią nazwę. Wywołaj swoją witrynę Hubzilli. Możesz preferować r2g. + +Opis. Użyj tego pola, aby opisać przeznaczenie aplikacji. Dodaj coś o efekcie użycia krzyżowego wysyłania z $Projectname do GNUsocial. + +Źródłowy adres URL. Wpisz nazwę domeny głównej witryny Red, której używasz. Nie zapomnij wpisać "s" w https://yourhubzillasite.com. Jeśli Twoja instalacja Red jest subdomeną, prawdopodobnie będzie to wymagane. + +Organizacja. Jeśli używasz tej instancji $Projectname dla grupy lub firmy, wypełnij to pole. + +Strona główna. Jeśli Twoja grupa korzysta z subdomeny, prawdopodobnie zechcesz umieścić tutaj identyfikator URI domeny głównej. + +Adres URL wywołania zwrotnego. Pozostaw puste. + +Typ aplikacji: wybierz "desktop." + +Domyślny dostęp: wybierz "Read-write." + +Wszystkie pola oprócz adresu URL wywołania zwrotnego muszą być wypełnione. + +Kliknij przycisk "Zapisz". + +Następnie kliknij ikonę lub nazwę aplikacji, aby wyświetlić informacje, które musisz wstawić w $Projectname. + +***** + +Otwórz teraz nową kartę lub okno i przejdź do swojego konta $Projectname, do ustawień Ustawienia > Właściwości. Znajdź ustawienia publikowania StatusNet. + +Wstaw w $Projectname ciągi liczb, podane na stronie GNUsocial, do pól klucza konsumenta i hasła konsumenta. + +Podstawową ścieżką API (pamiętaj o końcowym znaku /) będzie adres Twojej domeny i ścieżki "/api/". Prawdopodobnie będzie wyglądać tak: + +https://yourgnusocialinstance.org/api/ + +W przypadku wątpliwości sprawdź witrynę instancji GNUsocial, aby znaleźć adresy URL domeny tokenu żądania, tokenu dostępu i autoryzacji. Będzie to pierwsza część adresu URL domene, bez "/oauth/...." + +Nazwa aplikacji StatusNet: Wstaw nazwę, którą nadałeś aplikacji w witrynie GNUsocial. + +Kliknij "Prześlij". + +Pojawi się przycisk "Zaloguj się do StatusNet". Kliknij go, a otworzy się zakładka lub okno w witrynie GNUsocial, w którym możesz kliknąć "Zezwól". Po kliknięciu i pomyślnej autoryzacji pojawi się numer kodu bezpieczeństwa. Skopiuj go i wróć do aplikacji $Projectname, którą właśnie opuściłeś i wstaw ją w polu: "Tutaj skopiuj kod bezpieczeństwa ze StatusNet". Kliknij "Prześlij". + +Jeśli się powiedzie, Twoje informacje z instancji GNUsocial powinny pojawić się w aplikacji $Projectname. + +Jeśli chcesz, masz teraz do wyboru kilka opcji, które należy również potwierdzić, klikając "Prześlij". Najbardziej interesująca jest opcja "Domyślnie wysyłaj publiczne wpisy do StatusNet". Ta opcja automatycznie wysyła wszystkie wpisy, które napisałeś na koncie $Projectname do Twojej instancji GNUsocial. + +Jeśli nie wybierzesz tej opcji, będziesz mieć możliwość ręcznego wysłania wpisu do swojej instancji GNUsocial. W tym celu, najpierw otwórz wpis (klikając w obszarze tekstowym wpisu) i kliknik ikonę kłódki obok przycisku "Udostępnij". Wybierz ikonę GNUsocial składającą się z trzech kolorowych dymków dialogowych. Zamknij to okno, a następnie wykonaj swój wpis. + +Jeśli wszystko pójdzie dobrze, właśnie wysłałeś swój wpis z $Projectname na swoje konto w instancji GNUsocial. + +#include doc/macros/addons_footer.bb; + diff --git a/doc/pl/admin/administrator_guide.md b/doc/pl/admin/administrator_guide.md new file mode 100644 index 000000000..862cab15f --- /dev/null +++ b/doc/pl/admin/administrator_guide.md @@ -0,0 +1,385 @@ +### Przegląd + +$Projectname to więcej niż prosta aplikacja internetowa. Jest to złożony system komunikacyjny, który bardziej przypomina serwer poczty elektronicznej niż serwer WWW. Aby zapewnić niezawodność i wydajność, wiadomości są dostarczane w tle i umieszczane w kolejce do późniejszego dostarczenia, gdy lokacje są wyłączone. Ten rodzaj funkcjonalności wymaga nieco więcej zasobów hosta niż typowy blog. Nie każdy dostawca hostingu PHP-MySQL będzie w stanie obsługiwać $Projectname. Tak więc, przed instalacją zapoznaj się z wymaganiami i potwierdź je u dostawcy usług hostingowych. + +Bardzo staraliśmy się, aby Hubzilla działała na zwykłych platformach hostingowych, takich jak te używane do hostowania blogów Wordpress i stron internetowych Drupal. Będzie ona działać na większości systemów VPS Linux. Platformy Windows LAMP, takie jak XAMPP i WAMP, nie są obecnie oficjalnie obsługiwane, jednak mile widziane są poprawki, jeśli uda Ci się je uruchomić. + +### Gdzie można znaleźć więcej pomocy + +Jeśli napotkasz problemy lub sam masz jakiś problem, które nie zostały opisane w tej dokumentacji, poinformuj nas o tym za pośrednictwem narzędzia do [śledzenia problemów na serwisie Framagit](https://framagit.org/hubzilla/core/issues). Prosimy o jak najdokładniejsze opisanie swojego środowiska operacyjnego i podanie jak największej ilości informacji o wszelkich komunikatach o błędach, które mogą się pojawić, abyśmy mogli zapobiec ich występowaniu w przyszłości. Ze względu na dużą różnorodność istniejących systemów operacyjnych i platform PHP możemy mieć ograniczone możliwości debugowania instalacji PHP lub pozyskiwania brakujących modułów, ale dołożymy wszelkich starań, aby rozwiązać wszelkie ogólne problemy z kodem. + +### Zanim zaczniesz + +#### Wybierz nazwę domeny lub subdomeny dla swojego serwera + +Platformę $Projectname można zainstalować tylko w katalogu głównym domeny lub subdomeny i nie może ona działać na niestandardowych portach TCP. + +#### Zdecyduj, czy będziesz używać SSL i uzyskaj certyfikat SSL przed instalacją oprogramowania + +POWINNO się używać SSL. Jeśli używasz SSL, MUSISZ użyć certyfikatu uznawanego przez przeglądarki. **NIE WOLNO używać certyfikatów z podpisem własnym!** + +Przetestuj swój certyfikat przed instalacją. Narzędzie internetowe do testowania certyfikatu jest dostępne pod adresem http://www.digicert.com/help/. Odwiedzając witrynę po raz pierwszy, użyj adresu URL SSL (https://), jeśli protokół SSL jest dostępny. Pozwoli to uniknąć późniejszych problemów. Procedura instalacji nie pozwoli na użycie certyfikatu, który nie jest zaufany dla przeglądarki. + +To ograniczenie zostało wprowadzone, ponieważ Twoje publiczne wpisy mogą zawierać odniesienia do obrazów na Twoim portalu. Inni członkowie przeglądający swój strumień na innych portalach otrzymają w swojej przeglądarce ostrzeżenia, jeśli Twój certyfikat nie jest zaufany. To może zmylić wiele osób, ponieważ jest to zdecentralizowana sieć i otrzymają ostrzeżenie o Twoim portalu podczas przeglądania własnego portalu i mogą pomyśleć, że ich własny portal ma problem. Te ostrzeżenia są bardzo techniczne i przerażające dla niektórych osób, z których wielu nie będzie wiedziało, jak postępować i podporządkuje się zaleceniom przeglądarki. Jest to destrukcyjne dla społeczności. Zdajemy sobie sprawę z problemów związanych z obecną infrastrukturą certyfikatów i zgadzamy się, że istnieje wiele problemów, ale to nie zmienia wymagania - szyfrowanie połączeń HTTP jest konieczne. + +Bezpłatne certyfikaty zgodne z przeglądarkami są dostępne od dostawców, takich jak StartSSL czy LetsEncrypt. + +Jeśli NIE używasz SSL, może wystąpić opóźnienie do minuty dla startowego skryptu instalacyjnego - podczas sprawdzania portu SSL, aby zobaczyć, czy tam jest wszystko w porządku. Podczas komunikowania się z nowymi witrynami Hubzilla zawsze najpierw próbuje połączyć się z portem SSL, zanim powróci do mniej bezpiecznego połączenia. Jeśli nie używasz SSL, Twój serwer WWW NIE MOŻE w ogóle nasłuchiwać na porcie 443. + +Jeśli używasz LetsEncrypt do dostarczania certyfikatów i tworzenia pliku pod _well-known_ lub _acme-challenge_, aby LetsEncrypt mógł zweryfikować własność domeny, usuń lub zmień nazwę katalogu _.well-known_ zaraz po wygenerowaniu certyfikatu. $Projectname zapewni własną procedurę obsługi usług *.well-know* po zainstalowaniu, a istniejący katalog w tej lokalizacji może uniemożliwić poprawne działanie niektórych z tych usług. Nie powinno to stanowić problemu w przypadku Apache, ale może to być problem z Nginx lub innymi serwerami internetowymi. + +### Wdrożenie + +Nowy portal można wdrożyć na kilka sposobów: + +* ręczna inastalaja na istniejącym serwerze; +* automatyczna instalacja na istniejącym serwerze przy użyciu skryptu instalacyjnego; +* automatyczne wdrożenie przy użyciu prywatnego serwera wirtualnego OpenShift (VPS). + +### Wymagania + +* Apache z włączonym modułem _mod-rewrite_ i ustawioną dyrektywą "AllowOverride All", tak aby można było stosować plik _.htaccess_. Niektóre osoby z powodzeniem stosowały Nginx czy Lighttpd. Przykładowe skrypty konfiguracyjne są dostępne na tej platformie w [doc/install](). Apache and Nginx mają najlepsze wsparcie. + +* PHP 7.1 lub w wersji wyższej. + * _Proszę mieć na uwadze, że w niektórych środowiskach hostinu współdzielonego, wersja wiersza poleceń PHP różni się od wersji serwera internetowego_ + +* Dostęp do wiersza poleceń PHP z ustawionym w pliku php.ini parametrem _register_argc_argv_ na true i bez ograniczeń dostawcy hostingu w zakresie stosowania funkcji _exec()_ i _proc_open()_. + +* Rozszerzenia curl, gd (z obsługą co najmmniej jpeg i png), mysqli, mbstring, mcrypt, zip i openssl. Tozszerzenie imagick nie jest wymagane ale jest zalecane. + +* Wymagane jest rozszerzenie xml, jeśli chce sie mieć działajacą obsługę webdav. + +* Jakaś forma serwera pocztowego lub bramy pocztowej, taka jak działa PHP mail(). + +* Serwer bazy danych Mysql 5.x lub MariaDB lub PostgreSQL. + +* Możliwość planowania zadań dla crona. + +* WYMAGANA jest instalacja w katalogu głównym hosta WWW (wirtualnego hosta w Apache i bloku w Nginx). + +### Instalacja ręczna + +##### Krok 1. + +Rozpakuj pliki $Projectname do katalogu głównego obszaru dokumentów serwera WWW. Jeśli kopiujesz drzewo katalogów na swój serwer WWW, upewnij się, że dołączasz ukryte pliki, takie jak _.htaccess_. + +Jeśli możesz to zrobić, zalecamy użycie Git do sklonowania repozytorium źródłowego zamiast używania spakowanego pliku tar lub zip. To znacznie ułatwia późniejszą aktualizację oprogramowania. Polecenie Linux do sklonowania repozytorium do katalogu "mywebsite: wyglądałoby tak: + + git clone https://framagit.org/hubzilla/core.git mywebsite + +a następnie, w dowolnym momencie, możesz pobrać najnowsze zmiany za pomocą: + + git pull + +upewnij się, że istniejeją foldery `store/[data]/smarty3` i `store` i że są one możliwe do zapisu przez właściciela procesu serwera WWW: + + mkdir -p "store/[data]/smarty3" + chmod -R 777 store + +To uprawnienie (777) jest bardzo niebezpieczne i jeśli masz wystarczające uprawnienia i wiedzę powinieneś umożliwić zapisywanie w tych katalogach tylko przez serwer WWW i użytkownika, który uruchomia crona (patrz poniżej), jeśli jest taki. W wielu współdzielonych środowiskach hostingowych może to być trudne, bez zgłoszenia problemu u dostawcy. Powyższe uprawnienia pozwolą oprogramowaniu działać, ale nie są optymalne. + +Aby działały niektóre internetowe narzędzia administracyjne, serwer WWW musi mieć możliwość zapisu w następujących katalogach: + +* _addon_ +* _extend_ +* _view/theme_ +* _widget_ + +##### Krok 2. + +Utwórz pustą bazę danych i zanotuj szczegóły dostępu (nazwa hosta, nazwa użytkownika, hasło, nazwa bazy danych). Biblioteki bazy danych PDO powracają do komunikacji przez gniazdo uniksowe, gdy nazwą hosta jest _localhost_, ale niektóre osoby zgłosiły problemy z implementacją gniazda. Użyj gniazd, jeśli Twoje uprawnienia na to pozwalają. W przeciwnym razie, jeśli baza danych jest udostępniana na hoście _localhost_, jako nazwę hosta wpisz _127.0.0.1_. + +Wewnętrznie używamy teraz biblioteki PDO do połączeń z bazą danych. Jeśli masz do czynienia z konfigyracją bazy danych, którą nie możesz obsłużyć poprzez formularz konfiguracyjny (ma przykład w przypadku uzywania MySQL z nietypową lokalizacją gniazd) - możesz podać ciąg połączenia PDO jako nazwę hosta. Na przykład: + + :/path/to/socket.file + +W razie potrzeby nadal trzeba wypełnić w formularzu konfiguracyjnym wszystkie inne wartości mające zastosowanie. + +##### Krok 3. + +Utwórz pusty plik o nazwie _.htconfig.php_ i uczyń go możliwymm do zapisania przez serwer WWW. Krok ten wykonaj, jeśli wiesz, że serwer WWW nie będzie mógł sam utworzyć tego pliku. + +##### Krok 4. + +Odwiedź swoją witrynę za pomocą przeglądarki internetowej i postępuj zgodnie z instrukcjami. Zanotuj wszelkie komunikaty o błędach i popraw je przed kontynuowaniem. Jeśli używasz protokołu SSL (od znanego urzędu autoryzacyjnego), użyj schematu _https_ w adresie URL swojej witryny. + +##### Krok 5. + +Jeśli automatyczna instalacja nie powiedzie się z jakiegoś powodu, sprawdź następujące rzeczy: + +* Czy istnieje plik _.htconfig.php_? Jeśli nie, edytuj plik _htconfig.php_ i zmień w nim ustawienia systemowe. Następnie zmień jego nazwę na _.htconfig.php_. +* Czy baza danych jest wypełniona. Jeśli nie, zaimportuj treść skryptu _install/schema_xxxxx.sql_ w phpmyadmin lub wierszu poleceń mysql (zamień 'xxxxx' na własciwy typ bazy danych). + +##### Krok 6. + +Po udanej instalacji odwiedż ponownie swoją witrynę i zarejestruj swoje osobiste konto. Błędy rejestracji powinny dać sie naprawić automatycznie. + +Jeśli w tym momencie wystąpiła jakakolwiek *krytyczna* awaria, to na ogół przyczyna leży w źle funkcjonującej bazie danych. W takim przypadku, aby zacząć od nowa, usuń lub zmień nazwę pliku _.htconfig.php_ i usuń tabele bazy danych. + +Aby Twoje konto miało dostęp administratora, powinno to być utworzone jako pierwsze, a adres e-mail podany podczas rejestracji musi być zgodny z adresem administratora podanym podczas instalacji. Jeśli stało sie inaczej, aby dać dostęp administracyjny jakiemuś kontu, dodaj _4096_ w rekordzie tabeli _account_roles_ tego konta. + +Ze względu na bezpieczeństwo witryny, nie ma możliwości zapewnienia dostępu administracyjnego za pomocą formularzy konfiguracyjnych. + +##### Krok 7. BARDZO WAŻNY! + +Skonfiguruj zadanie Crona lub *zadanie zaplanowane*, tak aby uruchamiać menedżera Crona co 10-15 minut w celu przetwarzania i konserwacji w tle. Przykład: + + cd /base/directory; /path/to/php Zotlabs/Daemon/Master.php Cron + + +Zmień tutaj `/base/directory` i `/path/to/php` na właściwe dla siebie ścieżki. + +Jeśli używasz serwera linuksowego, uruchom polecenie `crontab -e` i dodaj wiersz taki jak poniżej, zmieniając odpowiednio ścieżki i ustawienia: + + */10 * * * * cd /home/myname/mywebsite; /usr/bin/php Zotlabs/Daemon/Master.php Cron > /dev/null 2>&1 + +Lokalizację PHP na ogół można ustalić wykonując polecenie _which php_. Jeśli masz problemy z ustawienie Crona, skontaktuj się z dostawcą hostingu w celu uzyskania pomocy. Hubzilla nie będzie działać prawidłowo bez tego kroku. + +Powinno się również sprawdzić ustawienie parametru _App::$config['system']['php_path']_ w pliku _.htconfig.php_. Powinno to wyglądać tak (zmień to zgodnie z lokalizacją PHP w swoim systemie): + + + App::$config['system']['php_path'] = '/usr/local/php56/bin/php'; + +#### Oficjalne dodatki + +##### Instalacja + +Przejdź do swojej witryny. Następnie sklonuj repozytorium dodatków (osobno). Nadamy temu repozytorium pseudonim `hzaddons`. Możesz pobrać inne repozytoria dodatków Hubzilla, nadając im różne pseudonimy: + + cd mywebsite + util/add_addon_repo https://framagit.org/hubzilla/addons.git hzaddons + +##### Aktualizacja + +W celu aktualizacji drzewa dodatków, powinno się, z poziomu głównego katalogu witryny, wydać polecenie aktualizacji tego repozytorium: + + cd mywebsite + util/update_addon_repo hzaddons + +Stwórz reprezentację dokumentacji online z możliwością wyszukiwania. Możesz to zrobić za każdym razem, gdy dokumentacja jest aktualizowana: + + cd mywebsite + util/importdoc + +### Automatyczna instalacja poprzez skrypt .homeinstall + +Istnieje skrypt powłoki _.homeinstall/hubzilla-setup.sh_, który po uruchomieniu zainstaluje Hubzillę i jego zależności na nowej instalacji stabilnej dystrybucji Debiana 9 (Stetch). Powinien działać na podobnych systemach Linux, ale wyniki mogą się różnić. + +#### Wymagania + +Skrypt instalacyjny został pierwotnie zaprojektowany dla małego serwera sprzętowego za routerem domowym. Jednak został przetestowany też na kilku systemach z Debian 9: + +* Home-PC (Debian-9.2-amd64) i Rapberry-Pi 3 (Rasbian = Debian 9.3) + * Połączenie z Internetem i domowy router + * Mini-PC lub Raspi połaczone z router + * Napęd USB dla kopii zapasowych + * Świeża instalacja Debian na swoim mini-pc + * Router z otwartymi portami 80 i 443 dla Debiana + +#### Etapy instalacji + +1. _apt-get install git_ +1. _mkdir -p /var/www/html_ +1. _cd /var/www/html_ +1. _git clone https://framagit.org/hubzilla/core.git ._ +1. _nano .homeinstall/hubzilla-config.txt_ +1. _cd .homeinstall/_ +1. _./hubzilla-setup.sh_ +1. _service apache2 reload_ +1. Open your domain with a browser and step throught the initial configuration of $Projectname. + +### Zalecane dodatki + +Zalecamy zainstalowanie następujących dodatków we wszystkich publicznych witrynach: + + nsfw - hide inappropriate posts/comments + superblock - block content from offensive channels + +### Dodatki federacyjne + +Kilka społeczności internetowych zaczęło łączyć się przy użyciu wspólnych protokołów. Stosowane protokoły mają nieco ograniczone możliwości. Na przykład protokół GNU-Social nie oferuje żadnych trybów prywatności, a protokół Diaspora +jest nieco bardziej restrykcyjny w zakresie dozwolonych rodzajów komunikacji. Wszystkie komentarze muszą być podpisane w bardzo unikalny sposób przez oryginalnego autora. Rozważany jest również protokół ActivityPub, który może być obsługiwany w przyszłości. Żaden inny istniejący protokół nie obsługuje lokalizacji nomadycznej używanej w tym projekcie. Stwarza to pewne problemy z obsługą, ponieważ niektóre funkcje działają w niektórych sieciach, a w innych nie. Niemniej jednak protokoły federacyjne umożliwiają nawiązywanie połączeń ze znacznie większą społecznością ludzi na całym świecie. Są dostarczane jako dodatki. + +* _diaspora_ - protokół diaspory używany przez Diasporę i Friendica. Najpierw należy włączyć „Diaspora Statistics” (statystyki), aby włączyć wszystkie dostępne funkcje. + +* _gnusoc_ - protokół społecznościowy GNU, używany przez GNU-Social, Mastodon i kilka innych społeczności. Ten dodatek wymaga najpierw zainstalowania usługi _pubsubhubbub_ (także dodatku). + +Każdy członek Twojej sieci musi indywidualnie zdecydować, czy zezwolić na te protokoły, ponieważ mogą one kolidować z kilkoma pożądanymi podstawowymi funkcjami i możliwościami Hubzilla (takimi jak migracja kanałów i klonowanie). Robi się to +na swojej stronie _Ustawienia_ -> _Ustawienia funkcji i dodatków_. Administrator może również ustawić: + + util/config system.diaspora_allowed 1 + util/config system.gnusoc_allowed 1 + +i włączać te protokoły automatycznie dla wszystkich nowo tworzonych kanałów. + +### Klasy usług + +Klasy usług pozwalają na ustawienie limitów zasobów systemowych poprzez ograniczenie tego, co mogą robić poszczególne konta, w tym przechowywania plików i najwyższych limitów wpisów. Zdefiniuj niestandardowe klasy usług zgodnie ze swoimi potrzebami w pliku _.htconfig.php_. Dla przykładu utwórzmy klasę standard i premium, używając następujący kod: + + // Service classes + + App::$config['system']['default_service_class']='standard'; // this is the default service class that is attached to every new account + + // configuration for standard service class + App::$config['service_class']['standard'] = + array('photo_upload_limit'=>2097152, // total photo storage limit per channel (here 2MB) + 'total_identities' =>1, // number of channels an account can create + 'total_items' =>0, // number of top level posts a channel can create. Applies only to top level posts of the channel user, other posts and comments are unaffected + 'total_pages' =>100, // number of pages a channel can create + 'total_channels' =>100, // number of channels the user can add, other users can still add this channel, even if the limit is reached + 'attach_upload_limit' =>2097152, // total attachment storage limit per channel (here 2MB) + 'chatters_inroom' =>20); + + // configuration for premium service class + App::$config['service_class']['premium'] = + array('photo_upload_limit'=>20000000000, // total photo storage limit per channel (here 20GB) + 'total_identities' =>20, // number of channels an account can create + 'total_items' =>20000, // number of top level posts a channel can create. Applies only to top level posts of the channel user, other posts and comments are unaffected + 'total_pages' =>400, // number of pages a channel can create + 'total_channels' =>2000, // number of channels the user can add, other users can still add this channel, even if the limit is reached + 'attach_upload_limit' =>20000000000, // total attachment storage limit per channel (here 20GB) + 'chatters_inroom' =>100); + +Aby zastosować klasę usług do istniejącego konta, użyj narzędzia wiersza poleceń z katalogu głównego instalacji Hubzilla: + +* uzyskanie listy klas usług: + + util/service_class + + +* ustawienie domyślnej klasy usług na _firstclass_: + + util/config system default_service_class firstclass + +* uzyskanie listy usług, które należą do klasy _firstclass_: + + util/service_class firstclass + +* ustawienie całkowitego użycia dysku ze zdjęciami _firstclass_ na 10 milionów bajtów + + util/service_class firstclass photo_upload_limit 10000000 + +* ustawienie konta z identyfikatorem 5 na klasę _firstclass_ (z potwierdzeniem): + + util/service_class --account=5 firstclass + +* ustawienie konta, które jest właścicielem kanału `blogchan` na klasę _firstclass_ (z potwierdzeniem) + + util/service_class --channel=blogchan firstclass + +**Opcje limitu klas usług** + +##### Opcje limitów klas usług: + +* _photo_upload_limit_ - maksymalna łączna powierzchnia dysku na przesłane pliki (w bajtach) +* _attach_upload_limit_ - maksymalna powierzchnia dysku na przesyłane załączniki plikow (w bajtach) +* _total_items_ - maksymalna liczba wpisów na najwyższym poziomie +* _total_pages_ - maksymalna liczba stron Comanche +* _total_identities_ - maksymalna liczba kanałów posiadanych na koncie +* _total_channels_ - maksymalna liczba kanałów +* _total_feeds_ - maksymalna liczba kanałów RSS + +* _minimum_feedcheck_minutes_ - najniższe ustawienie dozwolone dla odpytywania kanałów RSS +* _chatrooms_ - maksymalna liczba czatów +* _chatters_inroom_ - maksymalna liczba rozmówców w czacie +* _access_tokens_ - maksymalna liczba tokenów dostępu gościa na kanał + +### Zarządzanie motywami + +#### Przykład zarządzania repozytorium + +1) Przejdź na poziom katalogu głównego serwera: + + ``` + root@hub:/root# cd /var/www + ``` + +2) Dodaj repozytorium motywu i nadaj mu nazwę + + ``` + root@hub:/var/www# util/add_theme_repo https://github.com/DeadSuperHero/redmatrix-themes.git DeadSuperHero + ``` +3) Zaktualizuj repozytorium motywu + + ``` + root@hub:/var/www# util/update_theme_repo DeadSuperHero + ``` + +### Katalog kanałów + +#### Słowa kluczowe + +Na stronie katalogu kanałów może pojawiać się chmura słów kluczowych. Jeśli chcesz ukryć te słowa kluczowe, które są pobierane z serwera katalogów, możesz użyć narzędzia _config_: + + util/config system disable_directory_keywords 1 + +Jeśli twój portal pracuje w trybie autonomicznym, ponieważ nie chcesz łączyć się z globalną siecią, możesz zamiast tego ustawić opcję systemową _directory_server_ na wartość pustą: + + util/config system directory_server "" + +### Administrowanie + +#### Administrowanie witryną + +Administracja witryną jest zwykle wykonywana za pośrednictwem strony administratora znajdującej się na ścieżce _/admin_ adresu URL Twojej witryny. Aby uzyskać dostęp do tej strony, trzeba mieć uprawnienia administratora na serwerze. Prawa administracyjne są przyznawane pierwszemu kontu, które zostało zarejestrowane w witrynie, pod warunkiem, że adres e-mail tego konta dokładnie odpowiada adresowi e-mail podanemu jako adres e-mail administratora podczas konfiguracji. + +Istnieje kilka sposobów, w jakie może to się nie powieść i pozostawić system bez konta administratora, na przykład jeśli pierwsze konto, które zostało utworzone, miało inny adres e-mail niż adres e-mail administratora, który został podany podczas konfiguracji. + +Ze względów bezpieczeństwa w systemie nie ma strony internetowej ani interfejsu, który daje dostęp administratora. Jeśli potrzebujesz poprawić sytuację, w której system nie ma konta administratora, musisz to zrobić edytując tabelę kont w bazie danych. Nie ma innego wyjścia. Aby to zrobić, będziesz musiał zlokalizować wpis w tabeli kont, który należy do żądanego administratora i ustawić _account_roles_ dla tego wpisu na _4096_. Będziesz wtedy mógł uzyskać dostęp do strony administratora z menu profilu twojego systemu lub bezpośrednio na ścieżce _/admin_. + +Portal może mieć wielu administratorów i nie ma ograniczeń co do ich liczby. Powtórz powyższą procedurę dla każdego konta, któremu chcesz przyznać uprawnienia administracyjne. + +### Rozwiązywanie problemów + +#### Pliki dzienników + +Plik dziennika systemowego jest niezwykle przydatnym źródłem informacji do śledzenia błędów. Można to włączyć na stronie konfiguracji _admin/log_. Ustawienie poziomu o wartości *LOGGER_DEBUG* jest preferowany w stabilnej instalacji produkcyjnej. Większość problemów związanych z komunikacją lub przechowywaniem jest tutaj wymieniona. Ustawienie na *LOGGER_DATA* zapewnia znacznie więcej szczegółów, ale może wypełnić dysk. W obu przypadkach zalecamy użycie *logrotate* w systemie operacyjnym do cyklicznego tworzenia dzienników i usuwania starszych wpisów. + +Na dole twojego *.htconfig.php* znajduje się kilka linii (zakomentowanych), które umożliwiają rejestrowanie błędów PHP. Zgłaszane są problemy ze składnią i wykonywaniem kodu i jest to też pierwszym miejscem, w którym należy szukać problemów, które powodują "biały ekran" lub pustą stronę. Zwykle jest to wynikiem problemów z kodem lub składnią. Błędy bazy danych są zgłaszane do pliku dziennika systemowego, ale uznaliśmy, że przydatne jest umieszczenie w katalogu najwyższego poziomu pliku *dbfail.out*, który gromadzi tylko informacje o problemach związanych z bazą danych. Jeśli plik istnieje i można go zapisać, będą rejestrowane w nim błędy bazy danych, a także w pliku dziennika systemowego. + +W przypadku błędów "500: problemy mogą być często rejestrowane w dziennikach serwera internetowego, często w */var/log/apache2/error.log* lub podobnym. Zapoznaj się z dokumentacją systemu operacyjnego. + +Istnieją trzy różne obiekty dziennika. + +**Pierwsza to dziennik błędów bazy danych**. Jest on używane tylko wtedy, gdy utworzy się plik o nazwie **_dbfail.out_** w folderze głównym swojej witryny i pozwala na zapisywanie w nim przez serwer WWW. Jeśli masz jakiekolwiek zapytania do bazy danych, które nie powiodły się, wszystkie są zgłaszane tutaj. Zwykle wskazują na literówki w naszych zapytaniach, ale występują również w przypadku rozłączenia serwera bazy danych lub uszkodzenia tabel. W rzadkich przypadkach zobaczymy tutaj warunki wyścigu, w których dwa procesy próbowały utworzyć wpis *xchan* lub *cache* z tym samym identyfikatorem. Należy zbadać wszelkie inne błędy (zwłaszcza błędy uporczywe). + +**Drugi to dziennik błędów PHP**. Plik **_php.out_** jest tworzony przez procesor języka i zgłasza tylko problemy powstałe w środowisku językowym. Znowu mogą to być błędy składniowe lub błędy programistyczne, ale generalnie są one fatalne i skutkują "białym ekranem"; +na przykład PHP kończy działanie. Prawdopodobnie powinieneś zajrzeć do tego pliku też, jeśli coś pójdzie nie tak, co nie powoduje białego ekranu. Często zdarza się, że plik ten jest pusty przez wiele dni. + +Na dole dostarczonego pliku *.htconfig.php* znajduje się kilka linii, które, jeśli nie są zakomentowane, włączają dziennik PHP (niezwykle przydatny do znajdowania źródła błędów białego ekranu). Nie jest to robione domyślnie ze względu na potencjalne problemy z własnością pliku dziennika i uprawnieniami do zapisu oraz fakt, że domyślnie nie ma rotacji pliku dziennika. + +**Trzeci to "dziennik aplikacji"**. Jest to używane przez Hubzillę do zgłaszania tego, co dzieje się w programie i zwykle zapisywane są tu wszelkie trudności lub nieoczekiwane dane, które otrzymaliśmy. Jego nazwę (ścieżkę) trzeba podać na stronie "Administracja - Logi" (/admin/logs), np. *hubzilla.log* wskazuje na plik o tej nazwie zlokalizowany w katalogu głównym Hubzilla. Czasem zgłaszane są tu również komunikaty o stanie "pulsu", aby wskazać, że osiągnęliśmy określony punkt w skrypcie. Jest to dla nas najważniejszy plik dziennika, ponieważ tworzymy go samodzielnie wyłącznie w celu zgłaszania stanu zadań w tle i wszystkiego, co wydaje się dziwne lub nie na miejscu. Te błędy mogą być "śmiertelne", ale też niegroźne i po prostu nieoczekiwane. Jeśli wykonujesz zadanie i występuje problem, daj nam znać, co znajduje się w tym pliku, gdy wystąpił problem. Proszę nie wysyłaj nam 100 milionów zrzutów, bo tylko nas wkurzysz! Tylko kilka odpowiednich wierszy, ab można było wykluczyć kilkaset tysięcy wierszy kodu i skoncentrować się na tym, gdzie zaczyna się pojawiać problem. + +To są dzienniki Twojego serwisu. Zgłaszamy poważne problemy na każdym poziomie dziennika. Gorąco polecamy poziom dziennika *DEBUG* dla większości witryn. Dostarcza on trochę dodatkowych informacji i nie tworzy dużych plików dziennika. Kiedy pojawia się problem, który uniemożliwia wszelkie próby śledzenia, możesz wtedy włączyć na krótki czas poziom *DATA*, aby uchwycić wszystkie szczegóły struktur, z którymi mieliśmy do czynienia w tym czasie. Ten poziom dziennika zajmuje dużo miejsca, więc jest zalecany tylko na krótkie okresy lub w przypadku witryn testowych dla programistów. + +Zalecamy skonfigurowanie *logrotate* zarówno dla dziennika php, jak i dziennika aplikacji. Zazwyczaj co tydzień lub dwa zaglądam do *dbfail.out*, naprawiam zgłoszone problemy i zaczynam od nowego pliku. Podobnie jest z plikiem dziennika PHP. Odwołuję się do tego od czasu do czasu, aby sprawdzić, czy jest coś, co wymaga naprawy. + +Jeśli coś pójdzie nie tak i nie jest to błąd krytyczny, warto zajrzeć do pliku dziennika aplikacji. Można zrobić to tak: + +``` +tail -f logfile.out +``` + +ponieważ powtarzaja się wpisy dla operacju, która ma problemy. MOzna wstawić w kodzie dodatkowe instrukcje rejestracji, jeśli nie ma żadnej wskazówki, co się dzieje. Nawet coś tak prostego jak "got here" lub wydrukować wartości zmiennej, która może być podejrzana. Zachecamy aby to robić. Gdy już znajdziesz to, czego potrzebujesz, możesz wykonać: + +``` +git checkout file.php +``` + +aby natychmiast wyczyścić wszystkie dodane elementy rejestrowania. Skorzystaj z informacji z tego dziennika i wszelkich szczegółów, które możesz podać podczas badania problemu, aby zgłosić błąd - chyba że analiza wskazuje na źródło problemu. W takim przypadku po prostu to napraw. + +##### Rotowanie plików dziennika + +1. Włącz dodatek *Logrot* w [oficjalnym repozytorium dodatków hubzilla](https://framagit.org/hubzilla/addons). +1. Utwórz katalog w swoim katalogu głównym o nazwie `log` z uprawnieniami do zapisu przez serwer WWW. +1. Przejdź do ustawień administratora programu *Logrot* i wprowadź nazwę folderu, a także maksymalny rozmiar i liczbę zachowanych plików dziennika. + +#### Zgłaszanie problemów + +Zgłaszając problemy, staraj się podać jak najwięcej szczegółów, które mogą być potrzebne programistom do odtworzenia problemu i podać pełny tekst wszystkich komunikatów o błędach. + +Zachęcamy do dołożenia wszelkich starań, aby wykorzystać te dzienniki w połączeniu z posiadanym kodem źródłowym w celu rozwiązywania problemów i znajdowania ich przyczyn. Społeczność często jest w stanie pomóc, ale tylko Ty masz dostęp do +plików dziennika swojej witryny i ich udostępnianie jest uważane za zagrożenie bezpieczeństwa. + +Jeśli problem z kodem został odkryty, zgłoś go w bugtrackerze projektu (https://framagit.org/hubzilla/core/issues). Ponownie podaj jak najwięcej szczegółów, aby uniknąć ciągłego zadawania pytań o konfigurację lub powielanie problemu, abyśmy mogli przejść od razu do problemu i dowiedzieć się, co z nim zrobić. Zapraszamy również do oferowania własnych rozwiązań i przesyłania poprawek. W rzeczywistości zachęcamy do tego, ponieważ wszyscy jesteśmy wolontariuszami i mamy mało wolnego czasu. Im więcej osób pomaga, tym łatwiejsze jest obciążenie pracą dla wszystkich. W porządku, jeśli Twoje rozwiązanie nie jest idealne. Wszystko pomaga i być może uda nam się to poprawić. + diff --git a/doc/pl/admin/hub_snapshots.md b/doc/pl/admin/hub_snapshots.md new file mode 100644 index 000000000..64542733f --- /dev/null +++ b/doc/pl/admin/hub_snapshots.md @@ -0,0 +1,120 @@ +### Narzędzia migawek portalu + +Programiści Hubzilli często muszą przełączać się między gałęziami, które mogą mieć niekompatybilne schematy lub zawartość bazy danych. Poniższe dwa skrypty tworzą i przywracają pełne migawki instancji Hubzilli, w tym zarówno główny katalog sieciowy, jak i stan całej bazy danych. Każdy skrypt wymaga pliku konfiguracyjnego o nazwie *hub-snapshot.conf* znajdującego się w tym samym folderze i zawiera on określone katalogi i szczegóły bazy danych portalu. + +### Konfiguracja + +Format pliku konfiguracyjnego jest bardzo ścisły. Między nazwą zmiennej a wartością nie może być spacji. Zastąp tylko treść w cudzysłowach swoją konfiguracją. Zapisz ten plik jako *hub-snapshot.conf* obok skryptów. + + # Location of hub root. Typically this is the location of the Hubzilla repo clone. + HUBROOT="/var/www/" + # MySQL database name + DBNAME="hubzilla" + # MySQL database user + DBUSER="hubzilla" + # MySQL database password + DBPWD="akeufajeuwfb" + # The target snapshot folder where the git repo will be initialized + SNAPSHOTROOT="/root/snapshots/hubzilla/" + +### Migawka + +Przykład użycia: + + sh hub-snapshot.sh my-hub.conf "Commit message for the snapshot" + +**hub-snapshot.sh**: + + #!/bin/bash + + if ! [ -f "$1" ]; then + echo "$1 is not a valid file. Aborting..." + exit 1 + fi + source "$1" + #echo "$DBNAME" + #echo "$DBUSER" + #echo "$DBPWD" + #echo "$HUBROOT" + #echo "$SNAPSHOTROOT" + MESSAGE="snapshot: $2" + + if [ "$DBPWD" == "" -o "$SNAPSHOTROOT" == "" -o "$DBNAME" == "" -o "$DBUSER" == "" -o "$HUBROOT" == "" ]; then + echo "Required variable is not set. Aborting..." + exit 1 + fi + + if [ ! -d "$SNAPSHOTROOT"/db/ ]; then + mkdir -p "$SNAPSHOTROOT"/db/ + fi + if [ ! -d "$SNAPSHOTROOT"/www/ ]; then + mkdir -p "$SNAPSHOTROOT"/www/ + fi + + if [ ! -d "$SNAPSHOTROOT"/www/ ] || [ ! -d "$SNAPSHOTROOT"/db/ ]; then + echo "Error creating snapshot directories. Aborting..." + exit 1 + fi + + echo "Export database..." + mysqldump -u "$DBUSER" -p"$DBPWD" "$DBNAME" > "$SNAPSHOTROOT"/db/"$DBNAME".sql + echo "Copy hub root files..." + rsync -va --delete --exclude=.git* "$HUBROOT"/ "$SNAPSHOTROOT"/www/ + + cd "$SNAPSHOTROOT" + + if [ ! -d ".git" ]; then + git init + fi + if [ ! -d ".git" ]; then + echo "Cannot initialize git repo. Aborting..." + exit 1 + fi + + git add -A + echo "Commit hub snapshot..." + git commit -a -m "$MESSAGE" + + exit 0 + +### Przywracanie + + #!/bin/bash + # Restore hub to a previous state. Input hub config and commit hash + + if ! [ -f "$1" ]; then + echo "$1 is not a valid file. Aborting..." + exit 1 + fi + source "$1" + COMMIT=$2 + + if [ "$DBPWD" == "" -o "$SNAPSHOTROOT" == "" -o "$DBNAME" == "" -o "$DBUSER" == "" -o "$HUBROOT" == "" ]; then + echo "Required variable is not set. Aborting..." + exit 1 + fi + RESTOREDIR="$(mktemp -d)/" + + if [ ! -d "$RESTOREDIR" ]; then + echo "Cannot create restore directory. Aborting..." + exit 1 + fi + echo "Cloning the snapshot repo..." + git clone "$SNAPSHOTROOT" "$RESTOREDIR" + cd "$RESTOREDIR" + echo "Checkout requested snapshot..." + git checkout "$COMMIT" + echo "Restore hub root files..." + rsync -a --delete --exclude=.git* "$RESTOREDIR"/www/ "$HUBROOT"/ + echo "Restore hub database..." + mysql -u "$DBUSER" -p"$DBPWD" "$DBNAME" < "$RESTOREDIR"/db/"$DBNAME".sql + + chown -R www-data:www-data "$HUBROOT"/{store,extend,addon,.htlog,.htconfig.php} + + echo "Restored hub to snapshot $COMMIT" + echo "Removing temporary files..." + + rm -rf "$RESTOREDIR" + + exit 0 + diff --git a/doc/pl/admins.bb b/doc/pl/admins.bb new file mode 100644 index 000000000..9d5191f60 --- /dev/null +++ b/doc/pl/admins.bb @@ -0,0 +1,15 @@ +[h2]Dokumentacja dla administratorów portalu[/h2] +[h3]Wdrożenie swojego portalu[/h3] +[zrl=[baseurl]/help/install]Instalacja[/zrl] +[zrl=[baseurl]/help/red2pi]Instalowanie $Projectname na Raspberry Pi[/zrl] +[zrl=[baseurl]/help/Hubzilla_on_OpenShift]$Projectname na OpenShift[/zrl] +[h3]Utrzymywanie swojego portalu[/h3] +[zrl=[baseurl]/help/troubleshooting]Wskazówki dotyczące rozwiązywania problemów[/zrl] +[zrl=[baseurl]/help/theme_management]Zarządzanie motywami[/zrl] +[zrl=[baseurl]/help/hidden_configs]Poprawianie ukrytych konfiguracji $Projectname[/zrl] +[zrl=[baseurl]/help/service_classes]Klasy usługi[/zrl] +[zrl=[baseurl]/help/directories]Praca z katalogami i ich konfigurowanie[/zrl] +[h3]Najczęściej zadawane pytania[/h3] +[zrl=[baseurl]/help/faq_admins]FAQ dla administratorów[/zrl] + +#include doc/macros/main_footer.bb; diff --git a/doc/pl/bugs.bb b/doc/pl/bugs.bb new file mode 100644 index 000000000..3b3664dc8 --- /dev/null +++ b/doc/pl/bugs.bb @@ -0,0 +1,31 @@ +[h2]Błędy, problemy i rzeczy, które pojawiają się w nocy ...[/h2] +[h3]Coś poszło nie tak! Kto jest odpowiedzialny za naprawianie tego?[/h3] + +[b]$Projectname Community Server[/b] + +$Projectname Community Server to oprogramowanie typu Open Source, które jest utrzymywane przez "społeczność" - zasadniczo nieopłacanych ochotników. Nikt nie jest odpowiedzialny za naprawianie błędów. Pracujemy razem, aby oprogramowanie i sieć działały płynnie i bez błędów. Jesteś członkiem tej społeczności, więc potrzebujemy również Twojej pomocy, aby zapewnić wysokiej jakości oprogramowanie. Nie ma mitycznych "programistów", którzy w magiczny sposób wszystko naprawiają. Do nas wszystkich należy włączenie się i pomoc. + +Pierwszą rzeczą, którą musisz zrobić, jest porozimieć się z administratorem portalu - osobą, która obsługuje Twoją witrynę i zarządza nią. Znajdują się ona w wyjątkowej sytuacji, ponieważ ma dostęp do wewnętrznego oprogramowania i bazy danych oraz [b]plików dziennika[/b] i będzie musiała zaangażować się w naprawę problemu. Inne osoby "w sieci" nie mogą naprawdę Ci tym pomóc. Pierwszą rzeczą, jaką musi zrobić administrator węzła, jest przejrzenie dzienników i podjecie próby odtworzenia problemu. Dlatego staraj się być tak pomocny i uprzejmy, jak to tylko możliwe, pomagając mu przyjrzeć się problemowi. + +Aby znaleźć swojego administratora portalu (jeśli nie wiesz, kim on jest), zajrzyj na [url=[baseurl]/siteinfo]tą stronę[/url]. Jeśli nie podał on żadnych informacji kontaktowych na tej stronie lub nie podał "Impressum", zobacz [url=[baseurl]/siteinfo.json]podsumowanie informacji o tej witrynie[/url] znajdujące się pod nagłówkiem "admin:". + +Zdecydowanie zaleca się, aby administratorzy portali wypełniali raporty o błędach, tak aby możliwe było dołączenie odpowiedniego plik dziennika i informacji z bazy danych istotnych dla problemu oraz aby byli oni gotowi do wypróbowania rozwiązań i testów uzupełniających. Bez tego poziomu współpracy rozwiązanie problemu może nie być możliwe. + +[h3]Jestem administratorem portalu, co mam zrobić?[/h3] + +Oprogramowania zapewniające tą usługę sieciową jest typu Open Source i jest dostępne do wglądu. Zachęcamy wszystkich do zapoznania się z kodem i zobaczenia, jak wszystko działa i sprawdzenia, czy nie robimy nic złego lub niedbałego. Jeśli został zgłoszony komunikat o błędzie, często można przeszukać pliki źródłowe tego komunikatu o błędzie i dowiedzieć się, co go spowodowało. Dzięki tym informacjom i plikom dziennika serwisu możliwe będzie ustalenie sekwencji zdarzeń prowadzących do błędu. Problem mogą powodować również serwisy zewnętrzne i jego źródłem wcale nie musi być Twój serwis, ale inne miejsce w sieci. Spróbuj określić punkty końcowe komunikacji (węzły lub serwisy), których dotyczy problem i skontaktuj się z administratorem tego serwisu lub tych serwisów. Spróbuj podać czas zdarzenia, w którym coś poszło nie tak, aby można go było znaleźć w dziennikach. Współpracuj z innymi administratorami, aby spróbować znaleźć przyczynę problemu. Pliki dziennika są Twoim przyjacielem. Kiedy w oprogramowaniu dzieje się coś, czego się nie spodziewaliśmy, prawie zawsze zostało to zarejestrowane. + +[h3]Biały ekran śmierci[/h3] + +Jeśli podczas robienia czegoś pojawia się pusty biały ekran, prawie zawsze jest to błąd kodu lub składni. W pliku .htconfig.php serwisu znajdują się instrukcje, które pozwolą administratorowi witryny na włączenie rejestrowania składni. Zalecamy wszystkim witrynom korzystanie z tego. Po włączeniu rejestrowania składni powtórz sekwencję, która doprowadziła do błędu, a powinna ona zarejestrować nieprawidłową linię kodu. Mamy nadzieję, że dzięki tym informacjom uda Ci się rozwiązać problem. Gdy to zrobisz, prześlij poprawkę "upstream", abyśmy mogli udostępnić poprawkę pozostałym członkom projektu i innym społecznościom. To jest kluczowa zaleta korzystania z oprogramowania Open Source - dzielimy się mim wszyscy. + +[h3]Jestem głupi. Nie wiem, co jest nie tak.[/h3] + +W tej sytuacji warto omówić tę kwestię na jednym z forów internetowych. Może być ich kilka, a niektóre mogą bardziej pasować do Twojego ojczystego języka. W tej chwili kanał "Hubzilla Support" (support@zotadel.net) jest zalecanym forum do omawiania błędów. + +Jeśli członkowie społeczności z wykształceniem i doświadczeniem w zakresie inżynierii oprogramowania nie mogą Ci od razu pomóc, zrozum, że są wolontariuszami i mogą mieć dużo innej pracy i zobowiązań w tym czasie. W tym momencie musisz zgłosić błąd. Aby to zrobić, będziesz potrzebować konta na framagit.org. Zarejestruj się, a następnie odwiedź https://framagit.org/hubzilla/core/issues. Utwórz tutaj problem i podaj wszystkie te same informacje, które podałeś online. Nie pomijaj niczego. + +Następnie musisz zaczekać. Jeśli jest to poważny problem, może zostać szybko rozwiązany, ale nikt nie jest odpowiedzialny za naprawianie błędów. Jeśli problem utrzymuje się bez rozwiązania, poświęć trochę czasu na zbadanie samemu problemu. Zapytaj o wszystko, czego nie rozumiesz a co jest związane z tym problemem. Dowiesz się więcej o tym, jak działa oprogramowanie i prawdopodobnie dowiesz się, dlaczego teraz nie działa. Ostatecznie to ktoś w społeczności ma zamiar to naprawić, a ty jesteś członkiem społeczności. Tak właśnie działa proces Open Source. + +Inne osoby pracujące nad rozwiązaniem problemu mogą potrzebować dowiedzieć się więcej, więc odrób swoją pracę domową i udokumentuj, co się dzieje i wszystko, czego próbowałeś. Nie mów "Zrobiłem xyz i to nie działa". To nam nic nie mówi. Powiedz nam dokładnie, jakie kroki podjąłeś i jaki był rezultat, a także co się w rezultacie wydarzyło. Jaką stronę (URL) przeglądałeś lub jaki formularz wypełniałeś? Jeśli były jakieś komunikaty o błędach, nie mów "wystąpił komunikat o błędzie". Powiedz nam dokładnie, o czym była wiadomość. Powiedz nam również, z jakiego węzła korzystasz, jakiej wersji oprogramowania używasz i wszelkie inne szczegóły, które mogą być unikalne na temat konfiguracji Twojej witryny. Rozumie się, że możesz chcieć zachować prywatność niektórych informacji i swoich połączeń, jednak jeśli nie chcesz udostępniać informacji potrzebnych innym osobom do odtworzenia i rozwiązania problemu, może on nie zostać naprawiony. + diff --git a/doc/pl/checking_account_quota_usage.bb b/doc/pl/checking_account_quota_usage.bb new file mode 100644 index 000000000..a43b56944 --- /dev/null +++ b/doc/pl/checking_account_quota_usage.bb @@ -0,0 +1,20 @@ +[b]Sprawdzanie wykorzystania limitu konta (wykorzystanie limitów usług)[/b] + +Na Twoim węźle mogą zostać zaimplementowane limity klas usług, przypisujące ograniczenia do całkowitego rozmiaru miejsca na plików i zdjęci, ilosci kanałów i wpisów najwyższego poziomu, jakie może utworzyć właściciel konta dla określonego poziomu usług i inne ograniczenia. + +Oto, jak możesz szybko sprawdzić, ile z przydzielonego limitu aktualnie używasz: + +[b]Sprawdenie poziom limitów przechowywania plików[/b] +Odwiedź nastęþujący adres URL w przeglądarce: +[observer=1][observer.baseurl]/filestorage/[observer.webname][/observer] +[observer=0]example.com/filestorage/username[/observer] + +[b]Sprawdenie poziomu limitów miejsca na przesłane zdjęcia[/b] +[observer=1][observer.baseurl]/photos/[observer.webname][/observer] +[observer=0]example.com/photos/username[/observer] + +Przykład: +[observer=1][observer.baseurl]/filestorage/[observer.webname][/observer] +[observer=0]example.com/filestorage/username[/observer] + +#include doc/macros/main_footer.bb; diff --git a/doc/pl/comanche.md b/doc/pl/comanche.md new file mode 100644 index 000000000..fab2c134d --- /dev/null +++ b/doc/pl/comanche.md @@ -0,0 +1,272 @@ +Język opisu stron internetowych Comanche +======================================== + +Comanche to język znaczników podobny do bbcode, za pomocą którego można tworzyć rozbudowane i złożone strony internetowe, składając je z szeregu komponentów - z których niektóre są wstępnie skonstruowane, a inne można zdefiniować w locie. Firmalnie, Comanche jest językiem opisu stron, umozliwiajacym konstruowanie statycznych stron internetowych. + +Comanche przede wszystkim wybiera, jakie treści pojawią się w różnych regionach strony. Różne regiony mają nazwy i te nazwy mogą się zmieniać w zależności od wybranego szablonu układu. + +<a name="templates"></a> + +## Szablony stron +Obecnie istnieje pięć szablonów układu, ale portal może zapewniać dodatkowe układy + +**default** + +Szablon *default* definuje region 'nav' u góry strony, 'aside' jako pasek boczny o stałej szerokości, 'content' dla głównego obszaru treści i 'footer' dla stopki strony. Jest to szablon domyślny, jak wskazuje na to nazwa. + +**full** + +Szablon *full* definiuje to samo, co szablon "default", z tym wyjątkiem, że nie ma obszaru 'aside'. + +**choklet** + +Szablon *choklet* zapewnia szereg płynnych stylów układu, które można określać według odmiany: + +* (odmiana domyślna) - układ dwukolumnowy, podobny do szablonu domyślnego, ale bardziej płynny; +* bannertwo - układ dwukolumnowy z regionem bannera, zgodny z szablonem "default" na małych wyświetlaczach; +* three - układ trzykolumnowy (dodano region 'right_aside' do szablonu domyślnego); +* edgestwo - układ dwukolumnowy ze stałymi marginesami bocznymi; +* edgesthree - układ trzykolumnowy ze stałymi marginesami bocznymi; +* full - układ trzykolumnowy ze stałymi marginesami bocznymi i dodatkowym obszarem "header" poniżej paska nawigacji + +**redable** (sic) + +Szablon do czytania dłuższych tekstów na pełnym ekranie (czyli bez paska nawigacyjnego). Trzy kolumny: 'aside', 'content' i 'right_aside'. Aby zapewnić maksymalną czytelność, zaleca się używanie tylko środkowej kolumny treści. + +**zen** + +Daje swobodę robienia wszystkiego samemu. Po prostu pusta strona z obszarem zawartości. + +Użyj znacznika `template`, aby wybrać szablon układu (w tym przypadku "full"): + +``` + [template]full[/template] +``` + +W celu wyboru szablonu "choklet" w odmianie "three" użyj: + +``` + [template=three]choklet[/template] +``` + +Jeśli nie określono innego szablonu, zostanie użyty szablon domyślny. Szablon może używać dowolnych nazw dla regionów zawartości. Używa się znaczników `region`, aby zdecydować, jakie treści umieścić w odpowiednich regionach. + +Zostały też zdefiniowne trzy "makra", które można wykorzystać" + +``` + $htmlhead - zastępowane treścią nagłówka witryny. + $nav - zastępowane zawartością paska nawigacyjnego witryny. + $content - zastępowane główną zawartością strony. +``` + +Domyślnie, `$nav` jest umieszczne w regionie "nav" a `$content` w regionie "content". Makra te są potrzebne tylko wtedy, gdy chcesz zmienić rozmieszczenie tych elementów, tak aby zmienić kolejność lub przenieść je do innych regionów strony. + +W celu wybrania motywu dla swojej strony, trzeba użyć znacznika 'theme'. + +``` + [theme]suckerberg[/theme] +``` + +Polecenie to wybierze motyw o nazwie "suckerberg". Domyślnie zostanie użyty preferowany motyw Twojego kanału. + +``` + [theme=passion]suckerberg[/theme] +``` + +W tym przypadku, wybrany zostanie motywu o nazwie "suckerberg" i schemat "passion" (wariant motywu). Alternatywnie można użyć do tego skondensowanej notacji motywu. + +``` + [theme]suckerberg:passion[/theme] +``` + +Notacja skondensowana nie jest częścią samego Comanche, ale jest rozpoznawana przez platformę Hubzilla jako specyfikator motywu. + +<a name="regions"></a> + +## Regiony + +Jak wspomniano powyżej, każdy region ma nazwę. Konkretny region określa się za pomocą tagu "region", który zawiera jego nazwę. Jakakolwiek treść, którą chce się umieścić w tym regionie, powinna być umieszczona pomiędzy tagiem otwierającym a zamykającym region. + +``` + [region=htmlhead]....content goes here....[/region] + [region=aside]....content goes here....[/region] + [region=nav]....content goes here....[/region] + [region=content]....content goes here....[/region] +``` + +<a name="assets"></a> + +## CSS i Javascript + +Jest możliwość włączenia bibliotek Javascript i CSS do regionu htmlhead. Obecnie wykorzystujemy bibliteki jQuery (js), Bootstrap (css/js) oraz Foundation (css/js). + +Poniży kod spowoduje nadpisanie wybranych motywów htmlhead. + +``` + [region=htmlhead] + [css]bootstrap[/css] + [js]jquery[/js] + [js]bootstrap[/js] + [/region] + +``` + +<a name="menus-blocs"></a> + +## Menu i bloki + +Nasze narzędzia do tworzenia stron internetowych umożliwiają tworzenie również menu i bloków treści. Zapewniają one wyrenderowanie jakichś fragmentów treści strony, które można umieścić w dowolnych regionach i w dowolnej kolejności. Każdy z nich ma nazwę, którą określa się podczas tworzenia menu lub bloku. + +``` + [menu]mymenu[/menu] +``` + +Powyższy kod umieszcza menu o nazwie "mymenu" na stronie, ale musi ono znajdować się w jakimś regionie strony. + +``` + [menu=horizontal]mymenu[/menu] +``` + +Ten kod umieszcza menu o nazwie "mymenu" na stronie, tak jak kod poprzedni, ale dodatkowo zastosowano tu klasę CSS "horizontal" dla bloku menu. Klasa "horizontal" została zdefiniowana w motywie redbasic. Może, ale nie musi być dostępna w innych motywach. + +``` + [menu][var=wrap]none[/var]mymenu[/menu] +``` + +Zmienna [var=wrap]none[/var] w umieszczona w powyższym bloku usuwa otaczający menu element div. + +W poniższym przykładzie, w jakimś regionie umieszcza się blok o nazwie "contributors": + +``` + [block]contributors[/block] +``` + +Nastęþny przykład pokazuje blok o nazwie "contributors", podobnie jak powyżej, ale z zastosowaniem klasy "someclass". Zastępuje to domyślną klasę bloków "bblock widget": + +``` + [block=someclass]contributors[/block] +``` + +W poniższym przykładzie, zmienna [var=wrap]none[/var] umieszczona w bloku "contributors" usuwa z bloku otaczający go element div. + +``` + [block][var=wrap]none[/var]contributors[/block] +``` + +## Widżety + +Widgety to wykonywalne aplikacje dostarczane przez system, które możesz umieścić na swojej stronie. Niektóre widżety przyjmują argumenty, które pozwalają dostosować widżet do własnych potrzeb. + +Podstawowy system dostarcza: + +* profile - widżet, który powiela pasek boczny profilu na stronie kanału. Ten widżet nie wymaga żadnych argumentów; + +* tagcloud - udostępnia chmurę tagów kategorii; argumenty + + * count - maksymalna liczba tagów na liście + +Widżety i argumenty są określane za pomocą znaczników 'widget' i 'var'. + +``` + [widget=recent_visitors][var=count]24[/var][/widget] +``` + +Spowoduje to załadowanie widżetu "recent_visitors" i dostarczenie go z argumentem "count" ustawionym na "24". + +## Komentarze + +Znacznik 'comment' służy do wydzielenia komentarzy. Komentarze te nie pojawią się na wyrenderowanej stronie. + +``` + [comment]This is a comment[/comment] +``` + +## Instrukcje warunkowe + +Do wyboru rozwiązań można używać konstrukcji 'if'. Są one obecnie oparte systemowej zmiennej konfiguracyjnej lub bieżącym obserwatorze. + +``` + [if $config.system.foo] + ... zmienna konfiguracyjna system.foo przyjmuje wartość 'true'. + [else] + ... zmienna konfiguracyjna system.foo przyjmuje wartość 'false'. + [/if] + + [if $observer] + ... ta treść będzie wyświetlana tylko uwierzytelnionym odwiedzającym + [/if] +``` + +Klauzula 'else' jest opcjonalna. + +Oprócz oceny logicznej obsługiwanych jest kilka testów. + +``` + [if $config.system.foo == bar] + ... zmienna konfiguracyjna system.foo jest równa łańcuchowi 'bar' + [/if] + [if $config.system.foo != bar] + ... zmienna konfiguracyjna system.foo nie jest równa łańcuchowi 'bar' + [/if] + [if $config.system.foo {} bar ] + ... zmienna konfiguracyjna system.foo jest prostą tablicą zawierającą wartość 'bar' + [/if] + [if $config.system.foo {*} bar] + ... zmienna konfiguracyjna system.foo jest prostą tablicą zawierającą klucz o nazwie 'bar' + [/if] +``` + +## Złożony przykład + +``` + [comment]Użycie istniejącego szablonu strony, który zapewnia region banera a pod nim 3 kolumny[/comment] + + [template]3-column-with-header[/template] + + [comment]Użycie motywu "darknight"[/comment] + + [theme]darkknight[/theme] + + [comment]Użycie istniejącego menu nawigacyjnego witryny[/comment] + + [region=nav]$nav[/region] + + [region=side] + + [comment]Użycie wybranego przeze mnie menu i kilku widżetów[/comment] + + [menu]myfavouritemenu[/menu] + + [widget=recent_visitors] + [var=count]24[/var] + [var=names_only]1[/var] + [/widget] + + [widget=tagcloud][/widget] + [block]donate[/block] + + [/region] + + + + [region=middle] + + [comment]Show the normal page content[/comment] + + $content + + [/region] + + + + [region=right] + + [comment]Show my condensed channel "wall" feed and allow interaction if the observer is allowed to interact[/comment] + + [widget]channel[/widget] + + [/region] + +``` + +#include doc/macros/main_footer.bb; diff --git a/doc/pl/directories.bb b/doc/pl/directories.bb new file mode 100644 index 000000000..c59f71610 --- /dev/null +++ b/doc/pl/directories.bb @@ -0,0 +1,93 @@ +[h3]Konfiguracja katalogu[/h3] + +Katalogi w $Projectname służą do wyszukiwania i lokalizowania członków w całej sieci Zot. Są również używane do przechowywania i wysyłania zapytań o "oceny" członków i serwisów. Katalogi są dystrybuowane i dublowane, więc awaria jednej z nich nie spowoduje wyłączenia lub zakłócenia całej sieci. + +[b]Standardowa konfiguracja[/b] + +Nowe serwisy działają zaraz po uruchomieniu jako klienty katalogi będą, podczas pierwszego uruchomienia, automatycznie wybierać serwery katalogowe z zakodowanej listy. Możesz przeanalizować lub zmienić tą cechę za pomocą polecenia: + +[code] +util/config system directory_server +[/code] + +Aby ustawić inny serwer katalogowy: + +[code] +util/config system directory_server https://newdirectory.something +[/code] + +[b]Konfiguracja autonomicznego sewera[/b] + +Niektóre serwisy mogą chcieć działać w trybie "autonomicznym" i nie łączyć się z żądnymi zewnętrznymi serwerami katalogami. Jest to przydatne w przypadku serwisów izolowanych ("poza siecią") i serwisów testowych, ale może być również przydatne dla małych organizacji, które nie chcą łączyć się z innymi serwisami w sieci. + +Aby to skonfigurować, poszukaj w swoim pliku .htconfig.php następującego tekstu i odpowiednio ustaw konfigurację. + +[code] +// Configure how we communicate with directory servers. +// DIRECTORY_MODE_NORMAL = directory client, we will find a directory +// DIRECTORY_MODE_SECONDARY = caching directory or mirror +// DIRECTORY_MODE_PRIMARY = main directory server +// DIRECTORY_MODE_STANDALONE = "off the grid" or private directory services + +App::$config['system']['directory_mode'] = DIRECTORY_MODE_STANDALONE; +[/code] + + +[b]Konfiguracja serwera pomocniczego[/b] + +Można także skonfigurować swoją witrynę jako serwer pomocniczy. Działa to jako kopia lustrzana katalogu głównego i umożliwia podział obciążenia między dostępne serwery. Istnieje bardzo niewielka różnica funkcjonalna między podstawowym i pomocniczym serwerem, jednak może istnieć tylko jeden główny serwer katalogowy na dziedzinę (dziedziny są omówione w dalszej części tego dokumentu). + +Przed zdecydowaniem się na obsługę serwera katalogowego należy pamiętać, że trzeba być aktywnym członkiem sieci oraz mieć zasoby i czas do zarządzania tymi usługami. Zwykle nie wymaga to specjalnego zarządzania, ale niezbędna jest większa stabilność, ponieważ utrata serwera katalogów może powodować problemy z klientami katalogów, którzy są od niego zależni. + + +[b]Konfiguracja serwera katalogowego[/b] + +Jeśli serwer katalogowy wskazuje, że nie jest już serwerem katalogów, powinno to zostać wykryte przez oprogramowanie i konfiguracja tego serwera zostanie usunięta (wygaszona). Jeśli przejdzie w tryb offline na stałe bez ostrzeżenia, będziesz wiedzieć tylko wtedy, gdy członkowie witryny zgłoszą, że katalogi są niedostępne. Obecnie administrator witryny może to naprawić tylko ręcznie, wybierając nowy katalog i wykonując polecenie: + +[code] +util/config system directory_server https://newdirectory.something +[/code] + +Mamy nadzieję, że w przyszłości będzie to konfigurowane w polu do wyboru w panelu administracyjnego serwisu. + + +[h2]Dziedziny katalogów[/h2] + +Duże organizacje mogą chcieć używać "dziedzin" katalogów zamiast pojedynczego samodzielnego katalogu. Dziedzina standardowa i domyślna jest znana jako RED_GLOBAL. Tworząc nową dziedzinę, organizacja ma możliwość tworzenia własnej hierarchii serwerów głównych i pomocniczych oraz klientów. + +[code] +util/config system directory_realm MY_REALM +[/code] + +Twoja dziedzina musi mieć katalog główny. Utwórz to najpierw. Następnie ustaw tę samą dziedzinę we wszystkich serwisach w dziedzinie katalogu (serwerach i klientach). + +Możesz także podać "dziedzinę podrzędną", która działa niezależnie od dziedziny RED_GLOBAL (lub dowolnej innej dziedziny), ale umożliwia wzajemne członkostwo i pewne możliwości wyszukiwania członków w całej przestrzeni katalogu. To przeszło tylko lekkie testy, więc przygotuj się na pomoc i naprawienie wszelkich problemów, które mogą się pojawić. Dziedzina podrzędna zawiera dziedzinę nadrzędną w nazwie dziedziny. + + +[code] +util/config system directory_realm RED_GLOBAL:MY_REALM +[/code] + + +[b]Dostęp do dziedziny[/b] + +Można zrobić tak, aby Twoje serwery katalogowe i usługi były używane tylko przez członków Twojej dziedziny. W tym celu trzeba zastosować podawanie tokenu lub hasła, aby uzyskać dostęp do usług katalogowych dziedziny. Ten token nie jest szyfrowany podczas przesyłania, ale jest wystarczający, aby zapobiec przypadkowemu dostępowi do serwerów katalogowych. Dla wszystkich lokacji (klientów i serwerów katalogowych) w dziedzinie należy skonfigurować następujące elementy: + +[code] +util/config system realm_token my-secret-realm-password +[/code] + + +[h2]Katalogi lustrzane[/h2] + +Dublowanie odbywa się przy uzyciu dziennika transakcji, które są współużytkowane przez serwery katalogowe. W przypadku aktualizacji katalogu i profilu przesyłany jest adres kanału przeprowadzającego aktualizację, a inne serwery katalogów sondują ten kanał u źródła pod kątem zmian. Nie ufamy i nie powinniśmy ufać żadnym informacjom przekazanym nam przez inne serwery katalogowe. Informacje zawsze trzeba sprawdzać u źródła. + +Oceny są obsługiwane nieco inaczej - zaszyfrowany pakiet (podpisany przez kanał, który utworzył ocenę) jest przesyłany między serwerami. Ten podpis musi zostać zweryfikowany przed zaakceptowaniem oceny. Oceny są zawsze publikowane na głównym serwerze katalogów i stamtąd propagowane do wszystkich innych serwerów katalogów. Z tego powodu w dziedzinie może istnieć tylko jeden serwer główny. Jeśli źle skonfigurowana witryna twierdzi, że jest katalogiem głównym, jest ignorowana w dziedzinie RED_GLOBAL. W innych dzidzinach obecnie nie ma takiej ochrony. Należy o tym pamiętać podczas pracy z alternatywnymi dziedzinami. + +Nowo utworzone serwery katalogowe nie otrzymują "pełnego zrzutu", ale ze względu na wydajność i minimalne zakłócenia działania innych serwerów w sieci, są one powoli przełączane do trybu online. Może minąć nawet miesiąc, zanim nowy pomocniczy serwer katalogowy zapewni pełny widok sieci. Nie dodawaj żadnych serwerów pomocniczych do zakodowanej listy rezerwowych serwerów katalogowych, dopóki nie będą one działać jako katalog przez co najmniej miesiąc. + +Wszystkie kanały są skonfigurowane do "pingowania" swojego serwera katalogowego raz w miesiącu, w nieco losowych momentach w ciągu miesiąca. Daje to katalogowi możliwość wykrywania martwych kanałów i witryn (przestają one pingować). Następnie są oznaczane jako martwe lub nieosiągalne i z czasem będą usuwane z wyników katalogu. + +Kanały można skonfigurować tak, aby były "ukryte" w katalogu. Te kanały mogą nadal istnieć w katalogu, ale nie będzie można ich przeszukiwać, a niektóre "wrażliwe" informacje osobiste nie będą w ogóle przechowywane. + +
\ No newline at end of file diff --git a/doc/pl/feature/additional/access.md b/doc/pl/feature/additional/access.md new file mode 100644 index 000000000..80ad22c69 --- /dev/null +++ b/doc/pl/feature/additional/access.md @@ -0,0 +1,41 @@ +## Kontrola dostępu i uprawnienia + + +### Prywatne grupy + +Włączenie zarządzania i wyboru grup prywatności. +<!-- TODO: full description for Privacy Groups --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 0 + + +### Wiele profili + +Możliwość tworzenia wielu profili. +<!-- TODO: full description for Multiple Profiles --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 3 + + +### Kategorie uprawnień + +Podawanie alternatywnego ograniczenia uprawnień dla połączeń. +<!-- TODO: full description for Permission Categories --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 2 + + +### Klienty OAuth + +Zarządzaj tokenami uwierzytelniającymi dla aplikacji mobilnych i zdalnych. +<!-- TODO: full description for OAuth Clients --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 1 + + +### Tokeny dostępu + +Utwórz tokeny dostępu, aby osoby niebędące członkami mogły uzyskać dostęp do treści prywatnych. +<!-- TODO: full description for Access Tokens --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 2 diff --git a/doc/pl/feature/additional/calendar.md b/doc/pl/feature/additional/calendar.md new file mode 100644 index 000000000..d4af09366 --- /dev/null +++ b/doc/pl/feature/additional/calendar.md @@ -0,0 +1 @@ +## Kalendarz
\ No newline at end of file diff --git a/doc/pl/feature/additional/composition.md b/doc/pl/feature/additional/composition.md new file mode 100644 index 000000000..08b9205c4 --- /dev/null +++ b/doc/pl/feature/additional/composition.md @@ -0,0 +1,64 @@ +## Funkcje tworzenia wpisów + +### Duże obrazy + +Możliwość dołączania do wpisów dużych (1024px) miniatur zdjęć. Jeśli ta opcja nie jest jest włączona, będą używane małe miniatury (640 pikseli) +<!-- TODO: full description for Large Photos --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 1 + + +### Źródła kanałów + +Automatyczne importowanie zawartośvi kanału z innych kanałów lub źródeł +<!-- TODO: full description for Channel Sources --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 3 + + +### Jeszcze więcej szyfrowania + +Zezwalaj na opcjonalne szyfrowanie zawartości *end-to-end* za pomocą wspólnego tajnego klucza +<!-- TODO: full description for Even More Encryption --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 3 + + +### Włącz narzędzia do głosowania + +Podaj klasę wpisów, na które inni mogą głosować +<!-- TODO: full description for Enable Voting Tools --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 3 + + +### Wyłączenie komentowania + +Zapewnia opcję wyłączenia komentarzy do wpisu +<!-- TODO: full description for Disable Comments --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 2 + + +### Opóźnione wysyłanie + +Zezwolenie na publikację wpisów w późniejszym terminie +<!-- TODO: full description for Delayed Posting --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 2 + + +### Wygasanie treści + +Usuwanie wpisów i komentarzy albo prywatnych wiadomości w przyszłości. +<!-- TODO: full description for Content Expiration --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 1 + + +### Pomijanie powielonych wpisów i komentarzy + +Zapobiega publikowaniu wpisów o identycznej treści zapisanych mniej niż dwie minuty między zgłoszeniami. +<!-- TODO: full description for Suppress Duplicate Posts/Comments --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 1 diff --git a/doc/pl/feature/additional/filtering.md b/doc/pl/feature/additional/filtering.md new file mode 100644 index 000000000..1bf54b07b --- /dev/null +++ b/doc/pl/feature/additional/filtering.md @@ -0,0 +1,59 @@ +[ftset]: /settings/features "Dodatkowe funkcjonalności" + +## Sieć i filtrowanie strumienia + + +### Wyszukiwanie wg daty + +> Dostępna na stronie ... + +Możliwość wyboru wpisów według zakresów dat. +<!-- TODO: full description for Search by Date --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 1 + +### Zapisywane wyszukiwanie + +> dostępna na stronie [Dodatkowe funkcjonalności] [ftset] + +Zapis wyszukiwanego hasła do ponownego wykorzystania +<!-- TODO: full description for Saved Searches --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 2 + +### Karta "Osobista sieć" + +Włącza zakładkę, aby wyświetlać tylko wpisy sieciowe, z którymi uzytkownik miał interakcję. +<!-- TODO: full description for Network Personal Tab --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 1 + +### Karta "Nowa sieć" + +Włącza kartę, aby wyświetlić całą nową aktywność sieciową. +<!-- TODO: full description for Network New Tab --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 2 + + +### Narzędzie zaprzyjaźnienia + +Filtruje aktywność strumienia według głębokości relacji. +<!-- TODO: full description for Affinity Tool --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 1 + +### Sugerowane kanały + +Pokazuje sugestie dotyczące znajomych i połączeń. +<!-- TODO: full description for Suggest Channels --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 1 + + +### Filtrowanie połączenia + +Filtrowanie przychodzących wpisów na podstawie słów kluczowych lub treści (fraz). +<!-- TODO: full description for Connection Filtering --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 3 diff --git a/doc/pl/feature/additional/general.md b/doc/pl/feature/additional/general.md new file mode 100644 index 000000000..d48b559b0 --- /dev/null +++ b/doc/pl/feature/additional/general.md @@ -0,0 +1,128 @@ +## Funkcje ogólne + +### Linki dla nowych członków + +Wyświetla skrótowe menu z linkami dla nowych członków. +<!-- TODO: full description for New Member Links --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 1 + + +### Zaawansowane profile + +Dodatkowe sekcje profilu i pól wyboru. +<!-- TODO: full description for Advanced Profiles --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 1 + + +### Import/Export profili + +Zapisywanie i ładowanie szczegółów profilu ze stronu *sites/channels* +<!-- TODO: full description for Profile Import/Export --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 3 + + +### Strony internetowe + +Udostępnienie zarządzania stronami internetowymi na swoim kanale +<!-- TODO: full description for Web Pages --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 3 + + +### Wiki + +Dostarcza wiki dla kanału +<!-- TODO: full description for Wiki --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 2 + + +### Prywatne notatki + +Udostępnia narzędzie do przechowywania notatek i przypomnień (uwaga: niezaszyfrowane) +<!-- TODO: full description for Private Notes --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 1 + + +### Karty + +Tworzenie osobistych kart zadań +<!-- TODO: full description for Cards --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 1 + + +### Artykuły + +Tworzenie interaktywnych artykułów +<!-- TODO: full description for Articles --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 1 + + +### Wybór kanału nawigacji + +Umożliwienia zmiany kanału bezpośrednio z rozwijanego menu nawigacji +<!-- TODO: full description for Navigation Channel Select --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 3 + + +### Lokalizacja zdjecia + +Połączenie z mapą danych lokalizacyjnych zdjęcia, jeśli są dostępne w przesłanym zdjęciu. +<!-- TODO: full description for Photo Location --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 2 + + +### Dostęp do kontrolowanych czatów + +Zapewnij pokoje rozmów i usługi czatu z kontrolą dostępu. +<!-- TODO: full description for Access Controlled Chatrooms --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 1 + + +### Inteligentne urodziny + +Informowanie o strefie czasowej wydarzeń urodzinowych, jeśli znajomi są rozproszeni po całej globie. +<!-- TODO: full description for Smart Birthdays --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 2 + + +### Wybór strefy czasowej zdarzeń + +Umożliwia tworzenie wydarzeń w strefach czasowych innych niż autora kanału. +<!-- TODO: full description for Event Timezone Selection --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 2 + + +### Kanał premium + +Pozwala ustawić ograniczenia i warunki łączenia się ze swoim kanałem +<!-- TODO: full description for Premium Channel --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 4 + + +### Zaawansowane przeszukiwanie katalogu + +Umożliwia tworzenie złożonych zapytań wyszukiwania w katalogu. +<!-- TODO: full description for Advanced Directory Search --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 4 + + +### Zaawansowane ustawienia motywu i układu + +Umożliwia precyzyjne dostosowywanie motywów i układów stron +<!-- TODO: full description for Advanced Theme and Layout Settings --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 4 diff --git a/doc/pl/feature/additional/overview.md b/doc/pl/feature/additional/overview.md new file mode 100644 index 000000000..f8a9a0a84 --- /dev/null +++ b/doc/pl/feature/additional/overview.md @@ -0,0 +1,123 @@ +[ftset]: /settings/features "Dodatkowe funkcjonalności" + +## Dodatkowe możliwości + +W $Projectname, oprócz podstawowych ustawień konta i kanałów, każdy użytkownik może również zarządzać dodatkowymi funkcjonalościami związanymi ze swoim kontem i kanałami. Może to robić na stronie [Dodatkowe funkcjonalności] [ftset]. + +Oto omówienie dostępnych tam opcji, tak jak są wyświetlane na stronie [Dodatkowe funkcjonalności] [ftset]: + +<h3 id="calendar_settings">Kalendarz</h3> +Są to opcje, które można dodatkow włączyć dla wszystkich swoich kalendarzy. Można to zmienić indywidualnie w każdym kalendarzu. + +<h4>Rozpocznij tydzień kalendarzowy w poniedziałek</h4> +W kalendarzach $Projectname, domyślnie jest to niedziela. + +<h4>Wybór strefy czasowej wydarzenia</h4> +Zezwolenie na tworzenie wydarzeń w strefach czasowych innych niż strefa ustawiona dla kanału. + +<h3 id="channel_main_page_settings">Strona główna kanału</h3> +Kilka dodatkowych możliwości związanych ze stroną główną kanału. + +<h4>Wyszukaj po dacie</h4> +Możliwość wyboru wpisów według zakresów dat + +<h4>Chmura tagów</h4> +Udostępnienie osobistej chmury tagów na stronie swojego kanału +<!-- TODO: full description for Tag Cloud --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 2 + +<h4>Użyj trybu bloga/listy</h4> +Komentarze będą wyświetlane osobno + +<h3 id="connections_settings">Połączenia</h3> +Obecnie jest tu tylko ustawienie opcji umożliwiającej filtrowanie strumienia wg słów kluczowych lub treści (fraz). + +<h3 id="conversation_settings">Rozmowa</h3> +Kilka dodatkowych opcji rozszerzających obsługę rozmów (i dyskusji). + +<h3 id="directory_settings">Katalog</h3> +Dostępna tu opcja zaawansowanego przeszukiawania katalogu może być bardzo użyteczna dla osób chcących dotrzeć do konkretnych informacji publikowanych w sieci Hubzilla. + +<h4>Zaawansowane przeszukiwanie katalogu</h4> +Umożliwia tworzenie złożonych zapytań wyszukiwania w katalogu. + +<!-- TODO: full description for Advanced Directory Search --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 4 + +<h3 id="manage_settings">Zarządzanie</h3> +Dostępna tu opcja włącza funkcję zmiany kanału bezpośrednio z rozwijanego menu nawigacji. + +<h3 id="network_settings">Sieć</h3> +Znajduje się tu szereg opcji włączających funkcje związane z siecią i strumieniem sieciowym. Przede wszystkim dostępnych jest tu kilka dodatkowych filtrów i inne użyteczne funkcje. + +<h4>Filtr wydarzeń</h4> +Możliwość wyświetlania tylko wydarzeń + +<h4>Filtr ankiet</h4> +Możliwość wyświetlania tylko ankiet + +<h4>Zapisywane wyszukiwanie</h4> +Zapisywanie wyszukiwanych haseł do ponownego wykorzystania + +<!-- TODO: full description for Saved Searches --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 2 + +<h4>Zapisywane foldery</h4> +Możliwość umieszczania wpisów w folderach +<!-- TODO: full description for Saved Folders --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 2 + +<h4>Alternatywna kolejność strumienia</h4> +Możliwość uporządkowania strumienia według daty ostatniego wpisu, daty ostatniego komentarza lub nieprzeczytanych aktywności + +<h4>Filtr kontaktów</h4> +Możliwość wyświetlania wpisów autorstwa tylko wybranego kontaktu + +<h4>Filtr forów</h4> +Możliwość wyświetlania wpisów tylko z określonego forum + +<h4>Filtr wpisów osobistych</h4> +Możliwość wyświetlania tylko tych wpisów, z którymi miało się interakcję + +<h4>Użyj trybu bloga/listy</h4> +Komentarze będą wyświetlane osobno + +<h3 id="photos_settings">Zdjęcia</h3> + +<h4>Lokalizacja zdjecia</h4> + +Połączenie z mapą danych lokalizacyjnych zdjęcia, jeśli są dostępne w przesłanym zdjęciu + +<!-- TODO: full description for Photo Location --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 2 + +<h3 id="profiles_settings">Profile</h3> +W tej sekcji zawarte są opcje włączające dodatkowe funkcje dotyczące profilu. Jeśli chcesz i możesz zakładać na swoim koncie wiele profili (i tożsamości), włącz tu opcję "wiele profili". + +<h4>Profile zaawansowane</h4> + +Dodatkowe sekcje profilu i pól wyborów +<!-- TODO: full description for Advanced Profiles --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 1 + +<h4>Import/Export profilu</h4> +Zapisywanie i ładowanie szczegółów profilu ze stronu <i>sites/channels</i>. +<!-- TODO: full description for Profile Import/Export --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 3 + +<h4>Wiele profili</h4> +Umożliwienie tworzenia wielu profili i tożsamości, jeśli parametry konta to dozwalają. + +Powszechną praktyka jest limitowanie przydzielonych użytkownikowi zasobów serwera w ramach konta. Ogranicza się nie tylko powierzchnie dyskową ale i też ilość profili i tozsamości, jakie uzytkownik moze utworzyć. +<!-- TODO: full description for Multiple Profiles --> + +Wymagany minimalny poziom umiejętności technicznych, aby używać tę funkcję: 3 + + diff --git a/doc/pl/feature/additional/posts.md b/doc/pl/feature/additional/posts.md new file mode 100644 index 000000000..571e1a06e --- /dev/null +++ b/doc/pl/feature/additional/posts.md @@ -0,0 +1,57 @@ +## Narzędzia wpisów i komentarzy + + +### Etykietowanie społecznościowe + +Możliwość etykietowania istniejących wpisów +<!-- TODO: full description for Community Tagging --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 1 + + +### Kategorie wpisów + +Dodawanie kategorii do swoich wpisów +<!-- TODO: full description for wpis Categories --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 1 + + +### Reakcje emoji + +Dodawanie możliwość reakcji emoji do wpisów +<!-- TODO: full description for Emoji Reactions --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 1 + + +### Zapisywane foldery + +Możliwość umieszczania wpisów w folderach +<!-- TODO: full description for Saved Folders --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 2 + + +### Dezaprobata wpisów + +Możliwoąć dezaprobaty wpisów i komentarzy. +<!-- TODO: full description for Dislike wpiss --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 1 + + +### Wyróżnianie wpisów + +Możliwość oznaczania wyróżionych wpisów wskaźnikiem gwiazdki +<!-- TODO: full description for Star posts --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 1 + + +### Chmura tagów + +Udostępnienie osobistej chmury tagów na stronie swojego kanału +<!-- TODO: full description for Tag Cloud --> + +Wymagany minimalny poziom umiejętności technicznych do korzystania z tej funkcji: 2 diff --git a/doc/pl/general.bb b/doc/pl/general.bb new file mode 100644 index 000000000..b5be73665 --- /dev/null +++ b/doc/pl/general.bb @@ -0,0 +1,18 @@ +[h2]Informacja o projekcie i portalu[/h2] +[h3]$Projectname[/h3] +[zrl=[baseurl]/help/Privacy]Polityka prywatności[/zrl] +[zrl=[baseurl]/help/project/governance]Zarządzanie projektem[/zrl] +[zrl=[baseurl]/help/contributor/convenant]Porozumienie projektowe i kodeks postępowania[/zrl] + +[h3]Źródła zewnętrzne[/h3] +[zrl=[baseurl]/help/external-resource-links]Wykaz zasobów zewnętrznych[/zrl] +[url=https://framagit.org/hubzilla/core/]Główna witryna internetowa[/url] +[url=https://framagit.org/hubzilla/addons]Strona dodatków[/url] +[url=[baseurl]/help/credits]Podziękowania od $Projectname[/url] +[h3]O tym portalu $Projectname[/h3] +[zrl=[baseurl]/help/TermsOfService]Warunki świadczenia usług dla tego portalu[/zrl] +[zrl=[baseurl]/siteinfo]Inormacja o portalu (/siteinfo)[/zrl] +[zrl=[baseurl]/siteinfo/json]Szczegółowe informacje techniczne w formacie JSON(/siteinfo/json)[/zrl] + +#include doc/macros/main_footer.bb; + diff --git a/doc/pl/hidden_configs.bb b/doc/pl/hidden_configs.bb new file mode 100644 index 000000000..cdbad4d63 --- /dev/null +++ b/doc/pl/hidden_configs.bb @@ -0,0 +1,123 @@ +[h1]Zaawanasowana konfiguracja dla administratorów[/h1] + +[i]W tym dokumencie zakładamy, że jesteś administratorem.[/i] + +$Projectname zawiera wiele opcji konfiguracyjnych, które są niedostępne w głównym panelu administracyjnym. Są to na ogół opcje uważane za zbyt niszowe, zaawansowane lub mogące być źle interpretowane przez zwykłych użytkowników. + +Te ustawienia można modyfikować za pomocą powłoki, na poziomie katalogu Hubzilla najwyższego poziomu, posługując się skłądnią: + +[code]util/config cat key value[/code] +dla pojedynczej opcji konfiguracyjnej witryny, lub + +[code]util/pconfig channel_id cat key value[/code] +dla konfiguracji kanału (członkowskiej). + +W przypadku konfiguracji witryny, innym rozwiązaniem jest dodanie wiersza w pliku .htconfig.php, o składni: +[code]App::$config['cat']['key'] = 'value';[/code] + +[h2]Konfiguracja kanału (pconfig)[/h2] + +[dl terms="mb"] + [*= system.always_my_theme ] Stosowanie własnego motywu podczas oglądania kanałów na tym samym portalu. Jest to realizowane w dość pomysłowy sposób, gdy przegląda się kanały w motywie zależnym od Comanche. + [*= system.blocked ] Blokowanie tablicy xchans przez ten kanał. Z technicznego punktu widzenia jest to ukryta konfiguracja i nie należy tutaj nic zmieniać, ale niektóre dodatki (w szczególności superblok) udostępniają ją w interfejsie użytkownika. + [*= system.default_cipher ] Ustawienie domyślnego szyfrowania E2EE dla elementów. + [*= system.display_friend_count ] Ustawienie liczby połączeń wyświetlanych przez widżecie połączeń profilu. + [*= system.do_not_track ] Jako nagłówek przeglądarki. Ustawienie tego może spowodować załamanie wielu funkcji opartych na tożsamości. Naprawdę powinno się po prostu ustawić tylko takie uprawnienia, które mają sens i są niezbędne. + [*= system.forcepublicuploads ] Wymuszenie, aby przesłane zdjęcia były publiczne, gdy są przesyłane jako elementy na ścianie. O wiele bardziej sensowne jest po prostu prawidłowe ustawienie uprawnień - zrób to zamiast ustawiać tą opcję. + [*= system.network_page_default ] Ustawienie domyślnych parametrów dotyczących przeglądania strony internetowej. Powinno zawierać to samo zapytanie co filtrowanie ręczne. + [*= system.paranoia ] Ustawia poziom bezpieczeństwa sprawdzania adresu IP. Jeśli adres IP zalogowanej sesji ulegnie zmianie, ten poziom zostanie wykorzystany do określenia, czy konto powinno zostać wylogowane z powodu naruszenia bezpieczeństwa. Dostępne opcje: + 0 — brak sprawdzania IP + 1 — sprawdzenie 3 oktetów + 2 — sprawdzenie 2 oktetów + 3 — sprawdzenie, czy w ogóle są jakieś różnice + + [*= system.prevent_tag_hijacking ] Zapobieganie przejmowaniu przez obcej sieci hasztagów w swoich wpisach i kierowaniu ich do własnych zasobów. + [*= system.taganyone ] Wymaganie włączenia konfiguracji o tej samej nazwie. Zezwala na tagowanie @mention każdego, niezależnie od tego, czy jest się połączony, czy nie. To się nie skaluje. + [*= system.anonymous_comments ] Domyślnie lub jeśli jest ustawiona na 1, umożliwia ustawienie niestandardowych uprawnień tak, aby zezwalały na anonimowe (moderowane) komentarze, takie jak WordPress, moderowane przez właściciela kanału. Jeśli jest ustawiona na 0, żaden członek tej witryny nie może tego wybrać ani włączyć. + [*= system.user_scalable ] Określa, czy aplikacja jest skalowalna na ekranach dotykowych. Domyślnie włączone, aby wyłączyć trzeba ustawione na zero - prawdziwe zero, a nie tylko fałsz. +[/dl] + +[h2]Konfiguracja witryny[/h2] + +[dl terms="mb"] + [*= randprofile.check ] W przypadku żądania losowego profilu, najpierw sprawdza się, czy faktycznie profile takie są dostępne. + [*= randprofile.retry ] Liczba ponownych prób pobrania losowego profilu. + [*= system.admin_email ] Określenie adresu e-mail administratora tej witryny. Jest to wstęþnie ustawiane podczas instalacji. + [*= system.authlog ] Plik dziennika używany do rejestrowania błędów uwierzytelniania. Służy do podłączania do oprogramowania po stronie serwera, takiego jak fail2ban. Błędy uwierzytelniania są nadal rejestrowane w dziennikach głównych. + [*= system.auto_channel_create ] Dodanie elementów formularza niezbędnych do utworzenia pierwszego kanał na stronie rejestracji konta i utwórzemoa go (ewentualnie po sprawdzeniu przez e-mail lub po zatwierdzeniu przez administratora). Wyklucza to możliwość importowania kanału z innej witryny jako pierwszego utworzonego kanału w tej witrynie dla nowego konta. Użyj wraz z opcją system.default_permissions_role, aby usprawnić rejestrację. + [*= system.auto_follow ] Przy utworzeniu pierwszego kanału automatycznie obserwuj kanały tutaj wymienione - listę stron internetowych oddzielonych przecinkami (adresów w postaci członek@portal). + [*= system.blacklisted_sites ] Portale, dla których ma być całkowicie zablokowany dostęp do tego portalu - tablica adresów URL. + [*= system.block_public_search ] Podobne do block_public, z tą różnicą, że blokuje tylko publiczny dostęp do funkcji wyszukiwania. Przydatne w przypadku serwisów, które chcą być publiczne, ale bez możliwości publicznego przeszukiwania treści. + [*= system.cron_hour ] Określenie godziny, w której ma być uruchamiany cron_daily. Domyślnie, bez konfiguracji Cron będzie uruchamiany o północy czasu UTC. + [*= system.default_permissions_role ] Jeśli ustawiono prawidłową nazwę roli uprawnień, użyj tą rolę dla pierwszego kanału utworzonego przez nowe konto i nie pytaj o 'Typ kanału' w formularzu tworzenia kanału. Przykłady prawidłowych nazw to: 'social', 'social_restricted', 'social_private', 'forum', 'forum_restricted' i 'forum_private'. Więcej informacji znadziesz [tutaj](/help/roles). + [*= system.default_profile_photo ] Ustawienie zdjęcia profilowego, dla nowych kanałów. Powinna być to nazwa katalogu znajdującego się w images/default_profile_photos/ lub lub być pustą wartością. Jeśli opcja nie jest ustawione, zakłada się, że stosowany będzie obrazek 'rainbow_man'. + [*= system.directorytags ] Ustawienie liczby tagów słów kluczowych wyświetlanych na stronie katalogu. Wartość domyślna to 50. + [*= system.disable_directory_keywords ] Jeśli '1', nie pokazuj słów kluczowych z katalogu. Jeśli portal jest serwerem katalogowym, nie zezwalaj na zwracanie znaczników do żadnych klientów katalogu. Nie ustawiaj tego dla serwerów katalogowych w dziedzinie RED_GLOBAL. + [*= system.disable_discover_tab ] Pozwala to całkowicie wyłączyć możliwość wykrywania treści publicznych z witryn zewnętrznych. + [*= system.disable_dreport ] Jeśli '1', nie przechowuj raportów doręczenia ani nie stosuj do nich odnośników. + [*= system.dlogfile ] Plik dziennika używany do rejestrowania błędów programistycznych. Dokładnie to samo, co rejestrator w innym przypadku. To nie jest magia i wymaga własnych instrukcji logowania. Narzędzie programistyczne. + [*= system.email_notify_icon_url ] URL obrazu (32x32) do wyświetlenia w powiadomieniach e-mail (treści HTML). + [*= system.expire_delivery_reports ] Ważność raportów doręczeń w dniach - domyślnie 10. + [*= system.expire_limit ] Nie wygaszaj więcej niż ta liczba wpisów w kanale w ramach jednego uruchomienia wygaszania, aby nie wyczerpać pamięci. Domyślnie 5000. + [*= system.photo_storage_type] Jeśli '1', użyj systemu plików, zamiast bazy danych SQL, do przechowywania miniatur. Wartość domyślna to '0'. Wprowadzono w wersji 4.2. + [*= system.hidden_version_siteinfo ] Jeśli true, nie wyświetlaj wersji oprogramowania na stronach informacji o witrynie (system.hide_version również ukrywa wersję na tych stronach, ale to ustawienie *tylko* ukrywa wersję na stronach informacji o witrynie). + [*= system.hide_help ] Nie wyświetlaj linku do stron pomocy na pasku nawigacyjnym. + [*= system.hide_in_statistics ] Poinformuj serwery statystyk, aby całkowicie ukryły ten portal na liście portali. + [*= system.hide_version ] Jeśli true, nie zgłaszaj wersji oprogramowania na stronach internetowych ani w narzędziach. (*) Trzeba to ustawić w .htconfig.php. + [*= system.ignore_imagick ] Zignoruj imagick i używaj GD, nawet jeśli imagick jest zainstalowany na serwerze. Zapobiega to niektórym problemom z plikami PNG w starszych wersjach programu imagick. + [*= system.max_daily_registrations ] Ustaw maksymalną liczbę nowych rejestracji dozwolonych w jednym dniu. Przydatne, aby zapobiec nadmiernej subskrypcji po nagłym nagłośnieniu projektu. + [*= system.max_import_size ] Jeśli skonfigurowano, jest to maksymalna wielkość importowanej wiadomości tekstowej. Zwykle jest to 200 KB lub więcej, aby pomieścić prywatne zdjęcia Friendica, które są osadzane w wiadomości. + [*= system.max_tagged_forums ] Zapobieganie spamowi. Ogranicza liczbę tagowanych forów, które są rozpoznawane w każdym wpisie. Wartość domyślna to 2. Tylko pierwsze n tagów zostanie dostarczone jako forum, pozostałe nie spowodują dostarczenia. + [*= system.minimum_feedcheck_minutes ] Minimalny odstęp czasu między odpytywaniem źródeł kanałów RSS. Jeśli jest mniejszy niż interwał Cron, źródła danych będą odpytywane przy każdym uruchomieniu zadań Crona. Wartość domyślna to 60, jeśli nie jest ustawiona. Ustawienie witryny można również nadpisać dla każdego kanału za pomocą ustawienia klasy usług o nazwie 'minimum_feedcheck_minutes'. + [*= system.no_age_restriction ] Nie ograniczaj rejestracji do osób w wieku powyżej 13 lat. W wielu krajach pociąga to za sobą prawne obowiązki wymagające podania wieku i blokowania wszystkich danych osobowych nieletnich, dlatego przed zmianą należy sprawdzić lokalne przepisy. + [*= system.object_cache_days] Ustaw, jak długo ma być buforowana zawartość osadzona, bez ponownego pobierania. Wartość domyślna to 30 dni. + [*= system.openssl_conf_file ] Określa plik zawierający konfigurację OpenSSL. Wymagane w niektórych instalacjach systemu Windows do zlokalizowania w systemie pliku konfiguracyjnego openssl. Najpierw przeczytaj kod. Jeśli nie potrafisz odczytać kodu, nie baw się tym. + [*= system.openssl_encrypt ] Użyj mechanizmu szyfrowania openssl, wartość domyślna to false (używa wtedy mcrypt do szyfrowania AES). + [*= system.optimize_items ] Uruchamia optimise_table podczas niektórych zadań, aby baza danych była prawidłowa i nie zdefragmentowana. Jest to związane ze spadkiem wydajności podczas uruchamiania, ale w reaultacie powoduje, że rzeczy są nieco szybsze. Istnieją również narzędzia CLI do wykonywania tej operacji, które warto preferować, zwłaszcza w dużych serwisach. + [*= system.override_poll_lockfile ] Zignorowanie pliku blokady w procesie odpytywania, aby umożliwić jednoczesne działanie więcej niż jednego procesu. + [*= system.paranoia ] Tak samo jak pconfig, ale na poziomie całej witryny. Ustawienie to może być nadpisane przez ustawienia członkowskie. + [*= system.pin_types ] Tablica dozwolonych typów elementów, które mozna przypiąć. Wartości domyślne zależą od modułu, ale można je tutaj ponownie zdefiniować. + [*= system.photo_cache_time ] Jak długo buforować zdjęcia w sekundach. Wartość domyślna to 86400 (1 dzień). Dłuższy czas zwiększa wydajność, ale oznacza również, że zastosowanie zmienionych uprawnień trwa dłużej. + [*= system.platform_name ] Co zgłosić jako nazwę platformy na stronach internetowych i w statystykach. (*) Musi być ustawione w .htconfig.php + [*= system.rating_enabled ] Rozproszone raportowanie reputacji i gromadzenie danych. Ta funkcja jest obecnie poprawiana. + [*= system.poke_basic ] Zmniejsz liczbę wyrażeń szturchnięć ("poke verbs") do dokładnie 1 ("poke"). Wyłącz inne wyrażenia. + [*= system.proc_run_use_exec ] Jeśli 1, użycie wywołania systemowego exec w proc_run do uruchomienia zadania w tle. Domyślnie używamy proc_open i proc_close. W niektórych (obecnie rzadkich) systemach nie działa to dobrze. + [*= system.projecthome ] Wyświetl stronę projektu na swojej stronie głównej dla wylogowanych osób. + [*= system.projecthome ] Ustaw stronę główną projektu jako stronę główną swojego portalu. (Przestarzałe) + [*= system.register_link ] Ścieżka do strony z linku "Zarejestruj się" w formularzu logowania. W zamkniętych witrynach będzie to przekierowywać do 'pubsites'. W przypadku otwartych witryn zwykle przekierowuje do strony 'register', ale można to zmienić na niestandardową stronę oferującą subskrypcje lub cokolwiek innego. + [*= system.reserved_channels ] Nie zezwalaj członkom na rejestrowanie kanałów o nazwach wyszczególnionych na tej liście nazw rozddzielanych przecinkami (bez spacji). + [*= system.sellpage ] Adres URL wyświetlany na liście witryn publicznych, prowadzący do strony z cenami usług - parametry kont i ich cena itp. + [*= system.startpage ] Ustawienie domyślnej strony, która ma być otwierana po zalogowaniu do jakiegokolwiek kanału w tym serwisie. Ustawienie to może zostać nadpisane przez ustawienia użytkownika. + [*= system.sys_expire_days ] Ile dni należy zachować odkryte treści publiczne z innych serwisów. + [*= system.taganyone ] Zezwolenie na oznaczanie tagiem @mention każdego, niezależnie od tego, czy jest się połączonym, czy nie. + [*= system.tempdir ] Miejsce przechowywania plików tymczasowych (aktualnie nieużywane), domyślnie jest zdefiniowane w konfiguracji PHP. + [*= system.tos_url ] Ustawienie alternatywnego linku do lokalizacji ToS. + [*= system.transport_security_header ] Jeśli jest to wartość niezerowa i włączona jest obsługa SSL, stronach serwisu dołączany bedzie nagłówek HTTP strict-transport-security. + [*= system.uploaddir ] Lokalizacja katalogu przesyłania plików (domyślnie jest to system.tempdir, obecnie używany tylko przez wtyczkę js_upload). + [*= system.workflow_channel_next ] Strona do której sa kierowani wszyscy nowi członkowie bezpośrednio po utworzeniu kanału. + [*= system.workflow_register_next ] Strona do któtrej kierowani są członkowie bezpośrednio po utworzeniu konta (tylko wtedy, gdy włączona jest opcja auto_channel_create lub UNO). +[/dl] + + +[h3]Konfiguracja katalogu[/h3] + +[h4]Domyślne wartości przeszukiwania katalogu[/h4] + +[dl terms="mb"] + [*= directory.globaldir ] 0 lub 1. Domyślnie 0, jeśli odwiedza się katalog w witrynie, domyślnie zobaczy się tylko członków tej witryny. Trzeba przejść dodatkowy krok, aby zobaczyć osoby w pozostałej części sieci; Po zrobieniu tego, wyraźnie widać, że te osoby nie są członkami tego serwisu, ale należą do większej sieci. + [*= directory.pubforums ] 0 lub 1. Domyślnie 0 - publiczne fora. + [*= directory.safemode ] 0 lub 1. +[/dl] + +[h4]Konfiguracja serwera katalogowego[/h4][i](see [zrl=[baseurl]/help/directories]help/directories[/zrl])[/i] + +[dl terms="mb"] + [*= system.directory_mode ] + [*= system.directory_primary ] + [*= system.directory_realm ] + [*= system.directory_server ] + [*= system.realm_token ] +[/dl] + +#include doc/macros/main_footer.bb; + diff --git a/doc/pl/main.bb b/doc/pl/main.bb new file mode 100644 index 000000000..153e759cf --- /dev/null +++ b/doc/pl/main.bb @@ -0,0 +1,20 @@ +[img][baseurl]/images/hubzilla-banner.png[/img] + +[zrl=[baseurl]/help/about]Co to jest $Projectname?[/zrl] +$Projectname to bezpłatny i otwartoźródłowy zestaw aplikacji i usług internetowych działających na specjalnym serwerze internetowym, zwanym "portale" lub hubem ([i]ang. hub[/i]), który może łączyć się z innymi portalami w sfederalizowanej sieci internetowej. + +[zrl=[baseurl]/help/features]Możliwości $Projectname[/zrl] +$Projectname zapewnia użytkownikom zaawansowaną komunikację, tożsamości i usług kontroli dostępu, które bezproblemowo współpracują w różnych domenach i niezależnych witrynach internetowych. Pozwala użytkownikom [b]publicznie[/b] lub [b]prywatnie[/b] publikować treści za pośrednictwem "kanałów" (ang. channel), które są podstawowymi, zabezpieczonymi kryptograficznie tożsamościami zapewniającymi uwierzytelnianie niezależnie od portali, które je hostują. To rewolucyjne wyzwolenie tożsamości online z poszczególnych serwerów i domen jest nazywane "tożsamością nomadyczną" i jest oparte na protokole Zot, nowej strukturze zdecentralizowanej kontroli dostępu ze szczegółowymi, rozszerzalnymi uprawnieniami. +Z praktycznego punktu widzenia członków danego portalu, korzystających z oprogramowania $Projectname, oferuje ono szereg znanych, zintegrowanych aplikacji i usług internetowych, w tym: +[ul] +[li]wątki dyskusyjne w sieciach społecznościowych[/li] +[li]przechowywanie plików w chmurze[/li] +[li]kalendarz i kontakty (z obsługą CalDAV i CardDAV)[/li] +[li]hosting stron internetowych z systemem zarządzania treścią[/li] +[li]wiki[/li] +[li]i dużo więcej ...[/li][/ul] +Chociaż wszystkie te aplikacje i usługi można znaleźć w innych pakietach oprogramowania, tylko $Projectname pozwala ustawić uprawnienia dla grup i osób, [b]które mogą nawet nie mieć kont na Twoim portalu[/b]! W typowych aplikacjach internetowych, jeśli chcesz udostępniać rzeczy prywatnie w Internecie, osoby, którym udostępniasz dane, muszą mieć konta na serwerze, na którym znajdują się Twoje dane; w przeciwnym razie serwer nie może uwierzytelniać odwiedzających witrynę, aby wiedzieć, czy przyznać im dostęp. $Projectname rozwiązuje ten problem za pomocą zaawansowanego systemu zdalnego uwierzytelniania, który weryfikuje tożsamość odwiedzających, wykorzystując techniki obejmujące kryptografię klucza publicznego. +Dzięki oferowanym aplikacjom, $Projectname świetnie się nadaje do budowy platformy komunikacyjno-publikacyjnej o charkterze społecznościowym dla realnych grup społecznych, takich jak rodziny, lokalne grupy, organizacje społeczne, środowiska szkolne, wspólnoty mieszkańców czy wspólnoty religijne. + +[zrl=[baseurl]/help/what_is_zot]Co to jest Zot?[/zrl] +Jest to nowy protokół, oparty na JSON, do wdrażania bezpiecznej, zdecentralizowanej komunikacji i usług. Różni się od wielu innych protokołów komunikacyjnych, budując komunikację na podstawie zdecentralizowanej struktury tożsamości i uwierzytelniania. Składnik uwierzytelniania jest koncepcyjnie podobny do OpenID, ale jest odizolowany od tożsamości opartej na DNS. Tam, gdzie to możliwe, zdalne uwierzytelnianie jest ciche i niewidoczne. Zapewnia to mechanizm kontroli dostępu rozproszonego na skalę sieci WWW, który jest dyskretny. diff --git a/doc/pl/member/assets/qr_text_to_post.png b/doc/pl/member/assets/qr_text_to_post.png Binary files differnew file mode 100644 index 000000000..887c85492 --- /dev/null +++ b/doc/pl/member/assets/qr_text_to_post.png diff --git a/doc/pl/member/assets/zat_dialog.png b/doc/pl/member/assets/zat_dialog.png Binary files differnew file mode 100644 index 000000000..892964e95 --- /dev/null +++ b/doc/pl/member/assets/zat_dialog.png diff --git a/doc/pl/member/bbcode.html b/doc/pl/member/bbcode.html new file mode 100644 index 000000000..e04e59756 --- /dev/null +++ b/doc/pl/member/bbcode.html @@ -0,0 +1,343 @@ +<style> + section { + display: inline-block; + overflow-x: scroll; + } +</style> +<h2>Informacje o BBCode</h2> +<p> +W Hubzilla stosowana jest własna odmiana BBCode. Niniejszy informator jest +treściwym opisem składni tej odmiany BBCode. +</p> + +<h3>Dekracja tekstu</h3> +<table class="table table-responsive table-bordered"> + <tbody> + <tr> + <th>Składnia BBcode</th><th>Tekst formatowany</th> + </tr> + <tr> + <td><code>[b]pogrubiony[/b]</code></td><td><strong>pogrubiony</strong></td> + </tr> + <tr> + <td><code>[i]pochyły[/i]</code></td><td><em>pochyły</em></td> + </tr> + <tr> + <td><code>[u]podkreślony[/u]</code></td><td><u>podkreślony</u></td> + </tr> + <tr> + <td><code>[s]przekreślony[/s]</code></td><td><strike>przekreślony</strike></td> + </tr> + <tr> + <td><code>[color=red]czerwony[/color]</code></td><td><span style="color: red;">czerwony</span></td> + </tr> + <tr> + <td><code>[hl]podświetlony[/hl]</code></td><td><span style="background-color: yellow;">podświetlony</span></td> + </tr> + <tr> + <td><code>[font=courier]jaiś tekst[/font] </code></td><td><span style="font-family: courier;">jakiś tekst</span></td> + </tr> + <tr> + <td><code>[quote]cytat[/quote]</code></td><td><blockquote>cytat</blockquote></td> + </tr> + <tr> + <td><code>[quote=Author]Autor? Ja? Nie, nie, nie...[/quote]</code></td><td><strong class="author">Autor napisał:</strong><blockquote>Autor? Ja? Nie, nie, nie...</blockquote></td> + </tr> + <tr> + <td><code> + [size=small]tekst mały (small)[/size]<br> + [size=xx-large]tekst wielki (xx-large)[/size]<br> + [size=20]tekst z czcionką 20px[/size]<br> + </code> + Opcje rozmiaru obejmują: <strong>xx-small, small, medium, large, xx-large</strong></td><td><span style="font-size: small;">tekst mały (small)</span><br><span style="font-size: xx-large;">tekst wielki ()xx-large)</span><br><span style="font-size: 20px;">tekst z czcionką 20px</span></td> + </tr> + <tr> + <td><code>Dodanie poziomego paska +[hr] +Tak jak to + </code></td><td> + Dodanie poziomego paska<br><hr><br>Tak jak to + </td> + </tr> + <tr> + <td><code>To jest +[center]wyśrodkowany[/center] +tekst</code></td><td> + To jest<br><div style="text-align:center;">wyśrodkowany</div><br>tekst + </td> + </tr> + </tbody> +</table> + +<h3>Bloki kodu</h3> +Kod można renderować generalnie w formacie blokowym lub wbudowanym (w zależności od tego, czy w tekście znajdują się znaki nowego wiersza) lub można określić obsługiwany język dla rozszerzonego podświetlania składni. Podświetlanie składni wymaga odpowiedniej wtyczki renderującej, takiej jak <strong>hilite</strong>. Obsługiwane języki z wtyczką hilite to <strong>php, css, mysql, sql, abap, diff, html, perl, ruby, vbscript, avrc, dtd, java, xml, cpp, python, javascript, js, json, sh</strong>. +<br><br> +Jeśli wtyczka renderująca nie jest zainstalowana lub określono nieobsługiwany język, dane wyjściowe bloków kodu z podświetleniem składni są takie same, jak znacznik kodu formatu bloku. +<br><br> +<table class="table table-responsive table-bordered"> + <tbody> + <tr> + <th>Składnia BBcode</th><th>Wyjście</th> + </tr> + <tr> + <td><code>[code]funkcja bbcode() { }[/code]</code></td><td><code>funkcja bbcode() { }</code></td> + </tr> + <tr> + <td><code>[code=php]funkcja bbcode() {<br> + $variable = true;<br> + if( $variable ) {<br> + echo "true";<br> + }<br> +}[/code]</code></td><td><code><div class="hl-main"><ol class="hl-main"><li><span class="hl-code"> </span><span class="hl-reserved">function</span><span class="hl-code"> </span><span class="hl-identifier">bbcode</span><span class="hl-brackets">(</span><span class="hl-brackets">)</span><span class="hl-code"> </span><span class="hl-brackets">{</span><span class="hl-code"></span></li><li><span class="hl-code"> </span><span class="hl-var">$variable</span><span class="hl-code"> = </span><span class="hl-reserved">true</span><span class="hl-code">;</span></li><li><span class="hl-code"> </span><span class="hl-reserved">if</span><span class="hl-brackets">(</span><span class="hl-code"> </span><span class="hl-var">$variable</span><span class="hl-code"> </span><span class="hl-brackets">)</span><span class="hl-code"> </span><span class="hl-brackets">{</span><span class="hl-code"></span></li><li><span class="hl-code"> </span><span class="hl-reserved">echo</span><span class="hl-code"> </span><span class="hl-quotes">"</span><span class="hl-string">true</span><span class="hl-quotes">"</span><span class="hl-code">;</span></li><li><span class="hl-code"> </span><span class="hl-brackets">}</span><span class="hl-code"></span></li><li><span class="hl-code"> </span><span class="hl-brackets">}</span></li></ol></div></code></td> + </tr> + <tr> + <td><code>[nobb][nobb]W ten sposób [i]możesz[/i] +[u]pokazać[/u] jak użyć składnię +[hl]BBcode[/hl][/nobb][/nobb]</code></td><td>[nobb]W ten sposób [i]możesz[/i] [u]pokazać[/u] jak uzyć składnię []hl]BBcode[/hl][/nobb]</td> + </tr> + </tbody> +</table> + +<h3>Listy</h3> +<table class="table table-responsive table-bordered"> + <tbody> + <tr> + <th>Składnia BBcode</th><th>Wyrenderowana lista</th> + </tr> + <tr> + <td><code>[ul]<br> +[*] Pierwszy element listy<br> +[*] Drugo element listy<br> +[/ul]</code></td><td><ul class="listbullet" style="list-style-type: circle;"><li> Pierwszy element listy</li><li> Drugi element listy<br></li></ul></td> + </tr> + <tr> + <td><code>[ol]<br> +[*] Pierwszy element listy<br> +[*] Drugi element listy<br> +[/ol]</code></td><td><ul class="listdecimal" style="list-style-type: decimal;"><li> Pierwszy element listy</li><li> Drugi element listy<br></li></ul></td> + </tr> + <tr> + <td><code>[list=A]<br> +[*] Pierwszy element listy<br> +[*] Drugi element listy<br> +[/list]</code> + Elementami listy są <code>1, i, I, a, A</code>.</td><td><ul class="listupperalpha" style="list-style-type: upper-alpha;"><li> Pierwszy element listy</li><li> Drugi element listy</li></ul></td> + </tr> + <tr> + <td><code>[dl terms="b"]<br> +[*= Pierwsze hasło] Opis pierwszego hasła<br> +[*= Drugie hasło] Opis drugiego hasła<br> +[/dl]</code> + Opcje stylu <strong>hasła</strong> mogą być kombinacją tekstu: + <dl class="bb-dl dl-horizontal"> + <dt>b</dt><dd> z czcionką bold</dd> + <dt>i</dt><dd> z czcionką italic</dd> + <dt>u</dt><dd> z czcionką underline</dd> + <dt>m</dt><dd> z czcionką monospace</dd> + <dt>l</dt><dd> z czcionką large</dd> + <dt>h</dt><dd>poziomego — tak jak <em>tta</em> lista definicyjna</dd> + </dl> + </td><td><dl class="bb-dl dl-terms-bold"> +<dt> Pierwsze hasło</dt><dd> Opis pierwszego hasła<br></dd> +<dt> Drugie hasło</dt><dd> Opis drugiego hasła<br></dd></dl></td> + </tr> + </tbody> +</table> + +<h3>Tabele</h3> + +<table class="table table-responsive table-bordered"> + <tbody> + <tr> + <th>Składnia BBcode</th><th>Wyrenderowana tabela</th> + </tr> + <tr> + <td><code>[table border=0]<br> +[tr]<br> +[th]Nagłówek 1[/th][th]Nagłówek 2[/th]<br> +[/tr]<br> +[tr][td]Treść[/td][td]Treść[/td][/tr]<br> +[tr][td]Treść[/td][td]Treść[/td][/tr]<br> +[/table]</code></td><td><table class="table table-responsive"><tbody><tr><th>Nagłówek 1</th><th>Nagłówek 2</th></tr> +<tr><td>Content</td><td>Content</td></tr><tr><td>Treść</td><td>Treść</td></tr></tbody></table></td> + </tr> + <tr> + <td><code>[table border=1]<br> +[tr]<br> +[th]Nagłówek 1[/th][th]Nagłówek 2[/th]<br> +[/tr]<br> +[tr][td]Treść[/td][td]Treść[/td][/tr]<br> +[tr][td]Treść[/td][td]Treść[/td][/tr]<br> +[/table]</code></td><td><table class="table table-responsive table-bordered"><tbody><tr><th>Nagłówek 1</th><th>Nagłówek 2</th></tr> +<tr><td>Content</td><td>Content</td></tr><tr><td>Treść</td><td>Treść</td></tr></tbody></table></td> + </tr> + <tr> + <td><code>[table]<br> +[tr]<br> +[th]Nagłówek 1[/th][th]Nagłówek 2[/th]<br> +[/tr]<br> +[tr][td]Treść[/td][td]Treść[/td][/tr]<br> +[tr][td]Treść[/td][td]Treść[/td][/tr]<br> +[/table]</code></td><td><table><tbody><tr><th>Nagłówek 1</th><th>Nagłówek 2</th></tr><tr><td>Treść</td><td>Treść</td></tr><tr><td>Treść</td><td>Treść</td></tr></tbody></table> +</td> + </tr> + </tbody> +</table> + +<h3>Odnośniki i treść osadzona</h3> + +<table class="table table-responsive table-bordered"> + <tbody> + <tr> + <th>Składnia BBcode</th><th>Wyjście</th> + </tr> + <tr> + <td><code>[video]URL wideo[/video]<br> +[audio]URL audio[/audio]</code></td><td></td> + </tr> + <tr> + <td><code>[url=https://hubzilla.org]Hubzilla[/url]</code></td><td><a href="https://hubzilla.org" target="_blank">Hubzilla</a></td> + </tr> + <tr> + <td><code>Obraz [img]https://example.org/image.jpg[/img] +w jakimś tekście </code></td><td> + Obraz <img src="/images/default_profile_photos/rainbow_man/48.jpg" alt="Image/photo"> w jakimś tekście + </td> + </tr> + </tbody> +</table> + + +<h3>Kod specyficzny dla $Projectname</h3> + +<table class="table table-responsive table-bordered"> + <tbody> + <tr> + <th>Składnia BBcode</th><th>Wyjście</th> + </tr> + <tr> + <td>Wersja tagu [url] wykorzystująca magiczne uwierzytelnianie + <code>[zrl=https://hubzilla.org]Link rozpoznający tożsamość[/zrl]</code> + </td><td><code>https://hubzilla.org/?zid=[observer=1][observer.address][/observer][observer=0]your_channel@your.home.hub[/observer]</code></td> + </tr> + <tr> + <td>Wersja tagu [img] wykorzystująca magiczną uwierzytelnianie + <code>[zmg]https://hubzilla.org/some/photo.jpg[/zmg]</code> + </td><td>Obraz jest widoczny tylko dla osób uwierzytelnionych i za zgodą właściciela kanału.</td> + </tr> + <tr> + <td>Wyjście zależne od obserwatora:<code> + [nobb][observer=1]Tekst do wyświetlenia, jeśli obserwator JEST uwierzytelniony[/observer][/nobb] + </code></td><td></td> + </tr> + <tr> + <td> + <code> + [nobb][observer=0]Tekst wyświetlany, jeśli obserwator NIE JEST uwierzytelniony[/observer][/nobb] + </code> + </td> + <td></td> + </tr> + <tr> + <td> + <code> + [nobb][observer.language=en]Tekst wyświetlany, jeśli językiem obserwatora jest angielski[/observer][/nobb] + </code> + </td> + <td></td> + </tr> + <tr> + <td> + <code> + [nobb][observer.language!=de]Tekst wyświetlany, jeśli językiem obserwatora nie jest język niemiecki[/observer][/nobb] + </code> + </td> + <td></td> + </tr> + <tr> + <td> + <code> + [nobb][observer.url][/nobb] + </code> + </td> + <td>adres URL kanału obserwatora</td> + </tr> + <tr> + <td> + <code> + [nobb][observer.baseurl][/nobb] + </code> + </td> + <td>witryna WWW obserwatora</td> + </tr> + <tr> + <td> + <code> + [nobb][observer.name][/nobb] + </code> + </td> + <td>nazwa obserwatora</td> + </tr> + <tr> + <td> + <code> + [nobb][observer.webname][/nobb] + </code> + </td> + <td>krótka nazwa w adresie URL obserwatora</td> + </tr> + <tr> + <td> + <code> + [nobb][observer.address][/nobb] + </code> + </td> + <td>adres (ZOT-id) obserwatora</td> + </tr> + <tr> + <td> + <code> + [nobb][observer.photo][/nobb] + </code> + </td> + <td>zdjęcie profilowe obserwatora</td> + </tr> + <tr> + <td><code>Co to jest spoiler?<br> + [spoiler]Tekst, który chcesz ukryć.[/spoiler]</code></td><td> + Co to jest spoiler? <div onclick="openClose('opendiv-1131603764'); return false;" class="fakelink">Kliknij, aby otworzyć/zamknąć</div><blockquote id="opendiv-1131603764" style="display: none;">Tekst, który chcesz ukryć.</blockquote> + </td> + </tr> + <tr> + <td><code>[toc data-toc='div.page-body' data-toc-headings='h1,h2']</code><br> +Utwórz spis treści na stronie internetowej lub stronie wiki. Proszę zapoznać się z <a href="http://ndabas.github.io/toc/" target="_blank">oryginalnym widżetem TOC jQuery</a> aby uzyskać więcej informacji. + <ul> + <li>Opcjonalny parametr: 'data-toc'. Jeśli pominięty, domyślną wartością jest „body”</li> + <li>Opcjonalny parametr: 'data-toc-headings'. Jeśli pominięty, wartość domyślna to „h1, h2, h3”</li> + </ul></td><td></td> + </tr> + <tr> + <td><code>[nobb][rpost=title]Tekst do publikacji[/rpost][/nobb]</code><br> +Obserwator wróci do swojego macierzystego portalu, aby wprowadzić wpis z określonym tytułem i treścią. Obie opcje są opcjonalne</td><td><a href="[baseurl]/rpost?f=&title=title&body=Text+to+post" target="_blank">[baseurl]/rpost?f=&title=title&body=Text+to+post</a></td> + </tr> + <tr> + <td>Wymaga to wtyczki <a href="https://framagit.org/hubzilla/addons/tree/master/qrator"><strong>qrator</strong></a>.<br><code>[qr]tekst do publikacji[/qr]</code></td><td><img src="/doc/member/assets/qr_text_to_post.png"></td> + </tr> + <tr> + <td>Wymaga to odpowiedniej wtyczki mapy, takiej jak <strong><a href="https://framagit.org/hubzilla/addons/tree/master/openstreetmap">openstreetmap</a></strong>. + <code>[map]</code></td><td>Wygenerowanie wbudowanej mapy przy użyciu aktualnych współrzędnych plakatu w przeglądarce, jeśli lokalizacja przeglądarki jest włączona</td> + </tr> + <tr> + <td>Wymaga to odpowiedniej wtyczki mapy, takiej jak <strong><a href="https://framagit.org/hubzilla/addons/tree/master/openstreetmap">openstreetmap</a></strong>. + <code>[map=latitude,longitude]</code></td><td>Wygenerowanie mapy przy wykorzystaniu współrzędnych globalnych.</td></tr> + <tr> + <td>Wymaga to odpowiedniej wtyczki mapy, takiej jak <strong><a href="https://framagit.org/hubzilla/addons/tree/master/openstreetmap">openstreetmap</a></strong>. + <code>[map]Nazwa miejsca[/map]</code></td><td> +Wygenerowanie mapy dla podanej nazwanej lokalizacji. Zwracana jest pierwsza pasująca lokalizacja. Na przykład „Sydney” zazwyczaj zwraca Sydney w Australii, a nie Sydney w Nowej Szkocji w Kanadzie, chyba że określono dokładniejszą lokalizację. Zdecydowanie zalecamy skorzystanie z narzędzia podglądu wpisu, aby upewnić się, że masz prawidłową lokalizację przed wysłaniem wpisu. +</td> + </tr> + <tr> + <td><code>[&copy;]</code></td><td> © </td> + </tr> + </tbody> +</table> diff --git a/doc/pl/member/member_faq.bb b/doc/pl/member/member_faq.bb new file mode 100644 index 000000000..bb354fd9c --- /dev/null +++ b/doc/pl/member/member_faq.bb @@ -0,0 +1,11 @@ +[h3]Najczęściej zadawane pytania[/h3] +[h4]Mogę edytować tekst wpisu po jego zapisaniu, ale czy istnieje sposób na zmianę uprawnień?[/h4] +Krótka odpowiedź: Nie, nie ma takiej mozliwości. Są ku temu istotne powody. Możesz zmienić uprawnienia do swoich plików, zdjęć i polubień, ale nie do wpisów po ich zapisaniu. Główny powód jest taki, że po zapisaniu wpisu jest on rozpowszechniony albo na kanał publiczny, a stamtąd na inne serwery $Projectname albo do tych, do których miał trafić. Tak jak nie możesz odzyskać czegoś, co dałeś innej osobie, nie możesz zmienić uprawnień do wpisów w $Projectname. Musielibyśmy śledzić wszędzie, gdzie trafia Twój wpis, śledzić wszystkich, którym pozwoliłeś go zobaczyć, a następnie śledzić, od kogo go usunąć. +Jeśli wpis jest publiczny, jest to jeszcze trudniejsze, ponieważ $Projectname to globalna sieć i nie ma możliwości śledzenia wpisu, nie mówiąc już o jego niezawodnym odzyskaniu. Inne sieci, które mogą otrzymały Twój wpis, nie mają niezawodnego sposobu usunięcia lub odzyskania wpisu. +[h4]Pobrałem swój kanał i zaimportowałem go (sklonowałem swoją tożsamość) do innej witryny, ale nie ma treści, wpisów ani zdjęć. Co jest nie tak???[/h4] +Wpisy i zdjęcia oraz inne pliki są dostarczane niezależnie od podstawowych informacji o kanale. Wynika to z ograniczeń pamięci związanych z przechowywaniem rozmów i archiwizowania zdjęć. Wpisy i rozowy mogą być synchronizowane niezależnie od podstawowych informacji o kanale. Zdjęcia i archiwa plików można przesyłać za pomocą wtyczki, takiej jak "redfiles", która obecnie jest oznaczona jako "eksperymentalna". Tworząc tą funkcjonalność, pomyśleliśmy, że najważniejsze jest zachowanie wszystkich kontaktów. Twoi znajomi widzieli już Twoje stare treści. Wpisy i rozmowy miały następny priorytet i można je teraz synchronizować. Pliki i zdjęcia są ostatnim elementem, który całkowicie działa. Kiedy znajdziemy kogoś chętnego do zakończenia wdrażania tego, będzie to zrobione. :) +[h4]Nie widzę zasobów prywatnych[/h4] +Prawdopodobnie wyłączone są pliki cookie stron trzecich. Musisz je włączyć, aby zdalne uwierzytelnianie działało. +[h4]Jest wiele obcojęzycznych wpisów. Przetłumaczmy je automatycznie.[/h4] +Istnieje również wiele [b]prywatnych[/b] obcojęzycznych wpisów, ale usługi automatycznego tłumaczenia wymagałyby od nas przekazywania tych prywatnych wiadomości do usługi tłumaczeniowej. Nie wiemy, jak zostaną one wykorzystane na tych serwisach. Właściwie to wiemy, dzięki Edwardowi Snowdenowi. Naszym najlepszym rozwiązaniem jest projekt o nazwie [b][i]Apertium[/i][/ b], który jest tłumaczem open source, który możemy zainstalować lokalnie. Obecnie brakuje tłumaczeń na język niemiecki - które są najczęściej żądanymi tłumaczeniami w matrycy. Po raz kolejny zostanie to zrealizowane, gdy znajdziemy kogoś, kto naprawdę chce, aby to się stało. + diff --git a/doc/pl/member/member_guide.bb b/doc/pl/member/member_guide.bb new file mode 100644 index 000000000..1f39ef852 --- /dev/null +++ b/doc/pl/member/member_guide.bb @@ -0,0 +1,1023 @@ +[h3]Przegląd[/h3] + +Chociaż wiele funkcji i możliwości Hubzilli jest znanych osobom, które korzystały z serwisów społecznościowych i oprogramowania do blogowania, istnieje również sporo nowych koncepcji i funkcji, z którymi większość osób wcześniej się nie zetknęła. Niektóre z nowych pomysłów są związane ze zdecentralizowanym charakterem sieci; inne są związane z zaawansowanym systemem uprawnień, który jest niezbędny do ochrony prywatności danych. Celem tego przewodnika jest pomóc w zrozumieniu, jak tworzyć, konfigurować i używać tożsamość nomadyczną. + +[h3]Rejestracja[/h3] + +Nie wszystkie serwisy oparte na $Projectname umożliwiają otwartą rejestrację. Jeśli rejestracja jest dozwolona, zobaczysz łącze "Rejestracja" bezpośrednio pod formularzem logowania. Kliknięcie tego linku przeniesie Ciebie do strony rejestracyjnej. W niektórych serwisach, link ten może przekierować do innej witryny, która umożliwia rejestrację. Ponieważ wszystkie serwisy Hubzilla są połączone, nie ma znaczenia, gdzie znajduje się Twoje konto. + +[b]Twój ades e-mail[/b] + +Trzeba tu wprowadzić poprawny adres e-mail. Twój adres e-mail nigdy nie jest publikowany. Ten adres będzie używany do aktywacji konta, do ewentualnego wysyłania powiadomień o przychodzących wiadomościach lub wpisach oraz do odzyskiwania utraconych haseł. + +[b]Hasło[/b] + +Wprowadź wybrane hasło i powtórz je w drugim polu, aby upewnić się, że zostało wpisane poprawnie. Ponieważ Hubzilla oferuje zdecentralizowaną tożsamość, Twoje konto może zalogować Cię do wielu innych serwisów internetowych sieci Hubzilla. + +[b]Regulamin serwisu[/b] + +Kliknij to łącze, aby przeczytać dokument [zrl=[baseurl]/help/TermsOfService]Regulamin serwisu[/zrl]. Po ich przeczytaniu zaznacz pole w formularzu rejestracyjnym, aby to potwierdzić. + +[b]Rejestracja[/b] + +Po podaniu niezbędnych informacji, kliknij przycisk "Zarejestruj się". Niektóre serwisy mogą wymagać zatwierdzenia rejestracji przez administratora, zanim zostanie ona przetworzona, o czym osoba rejestrująca zostanie powiadomiona. Trzeba więc śledzić swoją pocztę e-mail (w tym folder ze spamem) w celu potwierdzenia rejestracji. + +[h3]Kanały[/h3] + +[h4][b]Co to są kanały?[/b][/h4] + +Kanały to zbiory treści powiązane z profilem. Kanał może mieć różną formę. Może reprezentować Ciebie (kanał osobisty), być witryną internetową, forum, albumem ze zdjęciami, czymkolwiek. Dla większości osób pierwszym kanałem jest kanał osobisty, reprezentujący tą osobę. + +Najważniejsze cechy kanału, który reprezentuje "Ciebie", to: +[ul] +[*]Bezpieczna i prywatna komunikacja "wolna od spamu" + +[*]Tożsamość i "pojedyncze logowanie" w całej sieci Hubzilla; + +[*]Kotrola prywatności i uprawnienia, które obejmują całą sieć; + +[*]Usugi katalogowe (np. Książka telefoniczna). +[/ul] +Krótko mówiąc, kanał, który reprezentuje Ciebie, "opisuje Ciebie w internecie". + +[h4][b]Uprawnienia w kanale oparte na rolach[/b][/h4] + +W celu uproszczenia zarządzaniem uprawnieniami w kanałach, w Hubzilla wprowadzono "role uprawnieniowe". Podczas tworzenia nowego kanału użytkownik jest proszony o wybranie roli jaką ma pełnić kanał. Z każdą z takich ról związany jest zestaw uprawnień. Najpopularniejszą rolą uprawnień jest rola sieci społecznościowej. Ma się wiele innych możliwości, dzięki opcjom, które są analogiczne do grup i stron na Facebooku, przestrzeni współpracy, kanałów aktualności (RSS) i nie tylko. Te role automatycznie konfigurują kilka różnych zmiennych systemowych, od uprawnień przyznanych znajomym, po domyślne ustawienia prywatności i opcje widoczności. Dostępne są zaawansowane konfiguracje, które umożliwiają dostosowanie każdego z tych parametrów do własnych potrzeb. Stwierdziliśmy jednak, że większość ludzi woli "ustawić i zapomnieć". Dalej opisano niektóre z różnych ról, które są obecnie dostępne oraz ich wpływ na prywatność uzytkownika i zdolność do interakcji. + +[h5][b]Kanał społecznościowy[/b][/h5] + +[b]- federacyjny[/b] + +Kanał tego rodzaju jest bardzo liberalnym profilem społecznościowym, który jest kompatybilny z innymi federacyjnymi sieciami społecznościowymi. Zasady zezwoleń są podobne do Twittera i w większości zgodne z Diasporą i Mastodonem. Prywatność ma niższy priorytet niż łatwość dostępu i łączenia się z innymi. Każdy w sieci Fediverse może komentować Twoje publiczne wpisy i wysyłać Ci prywatną pocztę. Domyślnie wpisy i inne publikowane elementy są publiczne, ale można do nich ograniczyć dostęp przy ich tworzeniu. Jesteś wymieniony w katalogu. Twoja obecność w Internecie i połączenia są widoczne dla innych. Ten tryb może zwiększyć narażenie na niepożądaną komunikację i spam. Rola ta nie jest ogólnie zalecana, chyba że musisz regularnie kontaktować się z członkami innych sieci. + +[b]- przeważnie publiczny[/b] + +Kanał jest typowym profilem społecznościowym. Twoje wpisy i opublikowane elementy są domyślnie publiczne, ale możesz to zmienić podczas tworzenia elementu i ograniczyć dostęp do niego. Jesteś wymieniony w katalogu. Twoja obecność w Internecie i połączenia są widoczne dla innych. Tylko osoby z bezpośrednich kontaktów mogą komentować Twoje publiczne wpisy i wysyłać Ci prywatną pocztę. Zasady pozwoleń są podobne do Facebooka. + +[b]- ograniczony[/b] + +Domyślnie wszystkie wpisy i opublikowane elementy są wysyłane do prywatnej grupy prywatności "Znajomi" i nie są upubliczniane. Do tej grupy prywatności są dodawani nowi znajomi. Jeśli chcesz, możesz to zmienić i utworzyć publiczny wpis lub inny publicznie dostępny element. Jesteś wymieniony w katalogu. Twoja obecność online (na czacie) i Twoje kontakty (znajomi) są widoczne dla przeglądających Twój profil. + +[b]- prywatny[/b] + +Domyślnie wszystkie wpisy i opublikowane elementy są wysyłane do grupy prywatności "Znajomi". Do tej grupy dodawani są Twoi nowi znajomi. Możesz to zmienić i utworzyć publiczny wpis lub inny element publiczny, jeśli chcesz. NIE jesteś wymieniony w katalogu. Tylko osoby z Twoich kontaktów mogą zobaczyć Twoje inne połączenia. Twoja obecność w Internecie jest ukryta. + + +[h5][b]Forum[/b][/h5] + +[b]- przeważnie publiczne[/b] + +Kanał typowy dla publicznego forum. Wpisy i publikowane elementy są domyślnie publiczne. Członkowie mogą publikować przez "!wzmiankę" lub wpis pełny. Zablokowane jest publikowanie zdjęć i innych elementów. Kanał jest widoczny w katalogu. Członkowie są dodawani automatycznie. + +[b]- ograniczone[/b] + +Domyślnie wszystkie wpisy i opublikowane elementy są wysyłane do grupy prywatności "Znajomi" kanału. Do tej grupy dodawani są nowi znajomi. Członkowie mogą publikować przez "!wzmiankę" lub wpis pełny, ale wpisy i odpowiedzi mogą być również widoczne dla innych odbiorców wpisów najwyższego poziomu, którzy nie są członkami. Kanał jest widoczny w katalogu. Członkowie muszą być ręcznie dodani przez właściciela forum. + +[b]- prywatne[/b] + +Domyślnie wszystkie wpisy i opublikowane elementy są wysyłane do grupy prywatności "Znajomi". Do tej grupy dodawani są nowi znajomi. Właściciel może to zmienić i w razie potrzeby utworzyć publiczny wpis lub element publiczny. Członkowie tego nie mogą. NIE jesteś wymieniony w katalogu. Tylko osoby z Twoich kontaktów mogą zobaczyć Twoje inne połączenia. Twoja obecność w Internecie jest ukryta. Członkowie muszą być dodani ręcznie przez właściciela forum. Wysyłanie przez "!wzmiankę" jest wyłączone. Wpisy można publikować wyłącznie za pośrednictwem wpisów pełnych i wysyłać do członków grupy prywatności "Znajomi". Nie są oni publicznie widoczni. + +[h5][b]Kanał RSS[/b][/h5] + +[b]- publiczny[/b] + +Podobne do kanału społecznościowego - głównie publicznego, ale dostosowany do źródeł kanałów RSS. Elementy mogą być swobodnie publikowane i pozyskiwane. Obecność w Internecie jest bez znaczenia, dlatego jest ukryta. Nowe połączenia są automatycznie zatwierdzane. + + +[b]- ograniczony[/b] + +Kanał nie jest wymieniony w katalogu. Obecność w Internecie jest bez znaczenia, dlatego jest ukryta. Kanał jest publikowany tylko dla członków grupy prywatności "Przyjaciele". Nowe połączenia są automatycznie dodawane do tej grupy prywatności. Członkowie muszą zostać ręcznie zatwierdzeni przez właściciela kanału. + + +[h5][b]Kanał specjalny[/b][/h5] + +[b]- celebrycki lub mównica[/b] + +Autorzy są wymienieni w katalogu. Komunikaty są domyślnie publiczne. Obecność w Internecie jest ukryta. Nie wolno komentować ani odpisywać w jakiejkolwiek formie, chociaż odwiedzający mogą "polubić" profil autora. + + +[b]- repozytorium gupowe[/b] + +Forum publiczne, które umożliwia członkom publikowanie plików, zdjęć i stron internetowych. + +[h5][b]Tryb niestandardowy i ekspercki[/b][/h5] + +Prywatność i uprawnienia ustawia się ręcznie, aby dopasować je do swoich potrzeb. + + +[h4][b]Tworzenie kanałów[/b][/h4] + +Po utworzeniu konta zostanie wyświetlony ekran "Dodaj kanał". Zwykle pierwszym kanałem będzie ten, który reprezentuje Ciebie, więc użycie własnego imienia i nazwiska (lub pseudonimu) jako nazwy kanału jest dobrym pomysłem. Nazwę kanału należy traktować jako tytuł lub krótki opis kanału. Pole "Wybierz krótki pseudonim" jest podobne do pola "Nazwa użytkownika". Wykorzystamy wszystko, co tu wpiszesz, do utworzenia adresu kanału, którego będą używać inne osoby do łączenia się z Twoim kanałem, a Ty będziesz używać to do logowania się w innych witrynach. Wygląda to jak adres e-mail i ma wpisuć [i]pseudonim@serwis_twojej_rejestracji.xyz[/i]. + +Możesz tworzyć dodatkowe kanały, korzystając z odnośnika "Menedżer kanałów". + +Gdy to zrobisz, Twój kanał będzie gotowy do użycia. Pod adresem [observer=1][observer.url][/observer][observer=0][baseurl]/channel/username[/observer] znajdziesz "strumień" swojego kanału. Tutaj pojawi się Twoja ostatnia aktywność w odwrotnej kolejności chronologicznej. Jeśli opublikujesz wpis w polu oznaczonym "udostępnij", wpis pojawi się u góry Twojego strumienia. Znajdziesz tu również linki do wszystkich innych obszarów komunikacji tego kanału. Menu z ikoną "hamburger" w większości motywów zapewnia nawigację do innych składników systemu i aplikacji. Strona "Zdjęcia" zawiera albumy ze zdjęciami, a strona "Wydarzenia" zawiera wydarzenia udostępnione przez Ciebie i Twoje kontakty. + +[h4][b]Profile[/b][/h4] + +W $Projectname użytkownik może mieć wiele profili. Można używać różnych profili, aby pokazać różne "strony siebie" różnym odbiorcom. Różni się to od posiadania różnych kanałów. Różne kanały pozwalają na przesyłanie zupełnie różnych zestawów informacji. Można mieć kanał dla siebie, kanał dla swojej drużyny sportowej, kanał dla swojej witryny internetowej lub cokolwiek innego. Profil pozwala na precyzyjne stopniowanie "aspektów" kanału. Na przykład Twój domyślny profil publiczny może mówić "Cześć, jestem Fred i lubię się śmiać". Możesz pokazać swoim bliskim znajomym profil z dopiskiem "i ja też lubię rzucać krasnoludami". + +Zawsze masz profil nazywany profilem "domyślnym" lub "publicznym". Ten profil jest zawsze ogólnodostępny i nie można go ukryć (mogą występować rzadkie wyjątki w witrynach uruchamianych prywatnie lub odłączonych). Można i raczej powinno się ograniczyć informacje, które udostępnia się w swoim profilu publicznym. + +Tak więc, jeśli chcesz, aby inni znajomi mogli Cię znaleźć, warto mieć następujące informacje w swoim profilu publicznym: + +[ul][*]Twoje prawdziwe imię i nazwisko lub przynajmniej pseudonim, który wszyscy znają; +[*]Twoje zdjęcie; +[*]Twoją lokalizacja, przynajmniej na poziomie kraju.[/ul] + +Ponadto, jeśli chcesz poznać osoby, które mają podobne zainteresowania, poświęć chwilę i dodaj do swojego profilu kilka "słów kluczowych". Na przykład "muzyka, linux, fotografia" lub cokolwiek innego. Możesz dodać dowolną liczbę słów kluczowych. + +Aby utworzyć alternatywny profil, najpierw przejdź do [zrl=[baseurl]/settings/features]Ustawienia > Dodatkowe funkcje[/zrl] i włącz tam opcję "Wiele profili", w przeciwnym razie nie będziesz mieć możliwości korzystania z więcej niż tylko profilu domyślnego. + +Następnie wybierz "Edytuj profile" z menu swojej witryny Hubzilla. Możesz edytować istniejący profil, zmienić zdjęcie profilowe, dodać rzeczy do profilu lub utworzyć nowy profil. Możesz także utworzyć "klon" istniejącego profilu, jeśli chcesz zmienić tylko kilka elementów, ale nie chcesz ponownie wprowadzać wszystkich informacji. Aby to zrobić, kliknij profil, który chcesz sklonować i wybierz tam "Klonuj ten profil". + +Na liście swoich profili możesz również wybrać kontakty, które mogą zobaczyć Twój dodatkowy profil. Wystarczy kliknąć "Edytuj widoczność" obok profilu (dostępne tylko dla profili, które nie są Twoim profilem domyślnym), a następnie kliknąć określone połączenia, aby je dodać lub usunąć z grupy osób, które mogą wyświetlać ten profil. + +Po wybraniu profilu osoba przeglądająca Twój profil zobaczy przypisany przez Ciebie profil prywatny. Jeśli nie są oni uwierzytelnieni, zobaczą Twój profil publiczny. + +Istnieje ustawienie, które pozwala opublikować swój profil w katalogu i zapewnić, że będzie można go znaleźć innym. Możesz zmienić to ustawienie na stronie "Ustawienia". + +Jeśli nie chcesz, aby Cię widziano w internecie, ustaw swój profil jako prywatny. + +[h4][b]Słowa kluczowe i wyszukiwanie w katalogu[/b][/h4] + +Na stronie katalogu możesz wyszukiwać osoby z opublikowanymi profilami. Obecnie przeszukiwane jest tylko pole nazwy i słowa kluczowe. Możesz również umieścić takie słowa kluczowe w swoim domyślnym profilu - które mogą być używane do wyszukiwania wspólnych zainteresowań z innymi członkami. Słowa kluczowe są używane w narzędziu propozycji kanałów i chociaż nie są widoczne w katalogu, są wyświetlane, gdy ktoś odwiedza stronę Twojego profilu. + +Na stronie "Połączenia" oraz w katalogu znajduje się odnośnik, odpowiednio do "Sugestii" lub "Propozycji kanałów". Pozwoli to znaleźć kanały, które mają pasujące lub podobne słowa kluczowe. Im więcej podasz słów kluczowych, tym trafniejsze będą wyniki wyszukiwania. Są one sortowane według trafności. + +Przecztaj też: + +[zrl=[baseurl]/help/pl/AdvancedSearch]Zaawansowane przeszukiwanie[/zrl] + +[h4][b]Sieć, uprawnienia i delegowanie[/b][/h4] + +Strona "Sieć" zawiera wszystkie najnowsze wpisy z całej sieci Hubzilla, wykazane w odwrotnej kolejności chronologicznej. Wpisy, które się tutaj pojawiają, zależą w dużej mierze od ustawionych przez siebie preferencji. Na najbardziej liberalnym poziomie uprawnień będziesz otrzymywać wpisy od zupełnie obcych osób. Na drugim końcu skali możesz zobaczyć wpisy tylko od znajomych - lub, jeśli czujesz się naprawdę niezainteresowany społecznością, tylko własne wpisy. + +Jak wspomniano na początku, możliwych jest wiele innych rodzajów kanałów, jednak procedura tworzenia jest taka sama. Różnica między kanałami polega przede wszystkim na przypisanych uprawnieniach. Na przykład kanał umożliwiający udostępnianie dokumentów współpracownikom w pracy prawdopodobnie wymagałby bardziej liberalnych ustawień "Może zapisywać w moim" publicznym "magazynie plików" niż na koncie osobistym. + +Możesz również przekazać kontrolę nad wpisami i połączeniami swoich kanałów, ale nie nad ich konfiguracjami, innemu kanałowi. Odbywa się to poprzez edycję połączenia i przypisanie mu uprawnień do administrowania zasobami Twojego kanału. + +[h3]Przyłączanie się do kanałów[/h3] + +Połączenie jest w $Projectname określane jako zestaw uprawnień, które nadało się komuś innemu do dostępu do swoich treści. W tradycyjnych aplikacjach sieci społecznościowych wszystkie połączenia mają takie same uprawnienia lub najwyżej dwa poziomy ("znajomi" i "obserwujący"). W Hubzilla można ustawić (dostosować) szereg oddzielnych uprawnień w zależności od sytuacji i relacji, jakie masz z innym kanałem. Możesz zezwolić komuś na wyświetlanie swoich wpisów, ale nie zdjęć. Możesz również odmówić im pozwolenia na komentowanie swoich wpisów lub wysyłanie prywatnych wiadomości do Ciebie. + +Jak przyłączyć się do jakiegoś kanału? + +Najpierw musisz znaleźć kanał, z którym chcesz się połączyć. Można to zrobić na dwa sposoby. Po pierwsze, ustaw opcję "Może przesyłać mi swój strumień i wpisy z kanału" na zezwoleniea dla "Wszystkich w tej sieci", co spowoduje dostęp do wpisów od zupełnie obcych osób do Twojej matrycy. Zapewni ci to dużo treści publicznych i miejmy nadzieję, że pomoże Ci znaleźć interesujących, zabawnych ludzi, fora i kanały. + +Następną rzeczą, jaką możesz zrobić, jest przejrzenie katalogu. Katalog jest dostępny w każdej witrynie Hubzilli, co oznacza, że wyszukiwanie z poziomu własnej witryny przyniesie wyniki z całej sieci. Możesz wyszukiwać według nazwy, zainteresowania, lokalizacji i słowa kluczowego. + +Jeśli znasz już czyjąś "webbie", możesz bezpośrednio się z tą osobą skontaktować. Webbie to identyfikator, który wygląda jak adres e-mail (na przykład bob@example.com), ale odnosi się do kogoś w otwartej sieci społecznościowej. Aby się połączyć, osoby te muszą używać kompatybilnego protokołu sieciowego. Domyślnie, nasze oprogramowanie obsługuje protokół "Zot", jednak dodatkowe protokoły mogą być dostarczane za pośrednictwem wtyczek (dodatków). Więcej informacji na temat łączenia się z kanałami w innych sieciach znajduje się poniżej. + +Aby połączyć się z innymi kanałem $Projectname: + +Odwiedź profil tego kanału, klikając jego zdjęcie w katalogu, matrycy lub komentarzach, a otworzy się strona główna kanału w przeglądarce kanału. Po lewej stronie ekranu zwykle jest widoczny link o nazwie "Connect". Kliknij i gotowe. W zależności od ustawień kanału, z którym się łączysz, być może będziesz musiał poczekać, aż właściciel zatwierdzi połączenie, ale nie musisz nic robić. Po zainicjowaniu połączenia zostaniesz przeniesiony do edytora połączeń. Dzięki temu możesz przypisać określone uprawnienia do tego kanału, jeśli chcesz wprowadzić jakiekolwiek zmiany. + +Aby połączyć się z kanałami w innych sieciach niż sieć $Projectname: + +Proces łączenia się z kanałami w innych sieciach (takich jak GNU-Social, Mastodon czy Diaspora) jest podobny - wpisz odpowiednie "webbie" do pola "Dodaj nowe połączenia" na stronie "Połączenia". Jednak zanim to zrobisz, odwiedź stronę "Ustawienia" ("Ustawienia funkcji i dodatków") i upewnij się, że w Twoim portalu jest dostępny odpowiedni protokół (Diaspora, GNU-Social/OStatus lub ActivityPub) i [b][i]jest aktywowany[/i] dla Twojego kanału[/b]. Te sieci (protokoły) nie obsługują migracji kont i niezależności lokalizacji, więc jeśli przeniesiesz lokalizację lub sklonujesz swój kanał w inne miejsce, komunikacja z tymi połączeniami może się nie udać. Z tego powodu protokoły te nie są domyślnie aktywowane, ale ich aktywacja wymaga Twojej zgodą. Aktywacja tych protokołów wiąże się z podjęciem ważkiego rozstrzygniecia korzyści płynących z kmunikowania się ze znajomymi w tych sieciach a z drugiej strony, zapewnieniem odporności konta na awarie serwera. + +Niektóre rodzaje komunikacji oferują więcej niż jeden protokół. Jeśli chcesz połączyć się z kimś na Mastodonie (na przykład), możesz użyć do komunikacji protokołu "Ostatus" lub "AactivityPub". Generalnie, protokół "ActivityPub" zapewnia lepszą obsługę niż "Ostatus", ale Hubzilla często wybiera pierwszy protokół, który odkryje i może to nie być to, czego chcesz. Możesz połączyć się z kimś przez określony protokół, poprzedzając nazwę protokołu w nawiasach kwadratowych na tym "webbie". Na przykład: + +[code] +[activitypub]https://foo.bar/foobar +[ostatus]foobar@foo.bar +[diaspora]foobar@foo.bar +[zot]foobar@foo.bar +[feed]https://foo.bar/foobar +[/code] + +Aby połączyć zię z kanałami RSS: + +Administrator portalu może zezwolić na łączenie się z kanałami RSS. Proces łączenia się z kanałem RSS jest taki sam, z wyjątkiem wpisania (lub wklejenia) adresu URL kanału w polu "Dodaj nowe połączenie". Kanały są przetwarzane tylko raz lub dwa razy dziennie, a administrator portalu może nałożyć ograniczenia na liczbę dodawanych kanałów. + +[h4][b]Blokowanie, ignorowanie, archiwizowanie i ukrywanie kanałów[/b][/h4] + +Kanały w książce adresowej mogą mieć statusy, takie jak [i]zablokowany[/i], [i]ignorowany[/i], [i]zarchiwizowany[/i] i [i]ukryty[/i]. Na stronie połączeń możesz zobaczyć zakładki, które wyświetlają kanały o tych statusach. Na stronach edycji połączenia możesz zmienić status kanału. + +Oto ich znaczenie: + +[b]Zablokowany:[/b] w kanale nie moża odczytywać elementów, niezależnie od uprawnień, ani zapisywać cokolwiek. + +[b]Ignorowany:[/b] w kanale można odczytywać elementy, jeśli ma się odpowiednie uprawnienia, ale nie można tu nic zapisywać. + +[b]Ukryty:[/b] kanał nie pojawia się na liście połączeń profilu, nikt nie może zobaczyć, że jesteś połączony, ale trzeba mieć na uwadze, że treści mogą nadal pojawiać się innych połączeniach, na przykład w odpowiedziach na wpisy. + +[b]Archiwizowany:[/b] jeśli kanał nie jest dostępny przez 30 dni, jest automatycznie oznaczany jako "zarchiwizowany". Wszystkie dane zostają zachowane, ale zatrzymane zostaje odpytywanie kanału w poszukiwaniu nowych informacji i usuwa się go z autouzupełniania. Jeśli później dowiesz się, że kanał wrócił do trybu online, możesz ręcznie przywrócić go z archiwum. + +[h4][b]Kanały Premium[/b][/h4] + +Niektóre kanały są oznaczone jako "kanały premium" i mogą wymagać pewnych działań ze strony odwiedzajacego, zanim będzie on mógł nawiązać połączenie. Przycisk "Połącz" w przypadku tych kanałów przeniesie Cię do strony zawierającej szczegółowe informacje o warunkach, które ustanowił właściciel kanału. Jeśli warunki zostaną zaakceptowane, połączenie będzie kontynuowane normalnie. W niektórych przypadkach, na przykład w przypadku celebrytów i światowej sławy wydawców, może to wymagać zapłaty. Jeśli nie zgadzasz się z warunkami, połączenie nie będzie kontynuowane lub może być kontynuowane, ale z ograniczonymi uprawnieniami dozwolonymi dla twoich interakcji z tym kanałem. + +[h3]Uprawnienia[/h3] +Uprawnienia w $Projectname są pełniejsze niż te, do których możesz być przyzwyczajony. To pozwala nam zdefiniować lepiej oceniane relacje niż czarno-białe: "ta osoba jest moim przyjacielem, więc może zrobić wszystko" lub "ta osoba nie jest moim przyjacielem, więc nie może nic zrobić", jak to ma miejsce w innych serwisach społecznościowych. + +[h4][b]Role uprawnieniowe[/b][/h4] + +Tworząc kanał, można wybrać różne "role" dla tego kanału. Tworzą one całą rodzinę uprawnień i ustawień prywatności, które są odpowiednie dla tej roli. Typowe role to "Społeczne - głównie publiczne", "Społeczne - głównie prywatne", "Forum - publiczne" i wiele innych. Zapewniają one pewien poziom prostoty zarządzania uprawnieniami. Wystarczy wybrać rolę, a odpowiednie uprawnienia zostaną zastosowane automatycznie. Możesz także wybrać "Tryb niestandardowy/ekspercki" i zmienić indywidualne ustawienia uprawnień w dowolny sposób. + +[h4][b]Domyślne ograniczenia uprawnień[/b][/h4] + +Istnieje wiele indywidualnych uprawnień. Kontrolują one wszystko, od przeglądania strumienia po możliwość czatowania z Tobą. Każde pozwolenie ma limit. Zakres tych uprawnień waha się od "Tylko ja" do "Wszyscy w Internecie" - chociaż niektóre zakresy mogą nie być dostępne dla niektórych uprawnień. Limit dotyczy każdej opublikowanej rzeczy, którą tworzysz, a która nie ma kontroli prywatności ani kontroli dostępu. Na przykład, jeśli publikujesz zdjęcie i nie wybrałeś określonej grupy odbiorców z pozwoleniem na jego przeglądanie, stosujemy ten limit. Te ograniczenia dotyczą wszystkiego w ramach tej reguły pozwolenia, więc nie możesz zastosować ograniczenia do jednego zdjęcia. Limit dotyczy wszystkich Twoich zdjęć. Jeśli wszystkie Twoje zdjęcia są widoczne dla wszystkich w Internecie i ograniczysz limit tylko do znajomych, wszystkie Twoje zdjęcia będą teraz widoczne tylko dla znajomych. + +[h4][b]Kontrola dostępu[/b][/h4] + +Kontrola dostępu jest preferowaną metodą zarządzania prywatnością w [i]większości[/i] przypadków, zamiast stosowania ograniczania uprawnień. Polega ona na utworzeniu list połączeń lub grup prywatności (lub obu na raz) i na podstawie listy kontroli dostępu (ACL) użytkownik decyduje, czy zezwolenie jest dozwolone. Lista kontroli dostępu jest dołączona do wszystkiego, co się publikuje. W przeciwieństwie do ograniczeń uprawnień, zmiana listy kontroli dostępu na jednym zdjęciu nie ma wpływu na żadne z pozostałych zdjęć. Możesz użyć grup prywatności i "domyślnej listy kontroli dostępu", aby utworzyć i zautomatyzować zarządzanie listami kontroli dostępu, tak aby zapewnić dowolny poziom prywatności dla wszystkiego, co publikujesz. + +Zdecydowanie zalecamy skorzystanie z ustawień "typowej sieci społecznościowej" podczas tworzenia pierwszego kanału, ponieważ umożliwia to innym komunikowanie się z Tobą i pomaga w razie trudności. Przekonasz się, że te ustawienia zapewniają tyle prywatności, ile chcesz - kiedy tego chcesz; ale także pozwalają komunikować się publicznie, jeśli zechcesz. Po opanowaniu obsługi możesz swobodnie korzystać z dużo bardziej prywatnych ustawień. + +[dl terms="l"] +[*= Zakresy uprawnień to:] +[dl terms="i"] + [*= Nikt oprócz Ciebie ] To jest oczywiste. Tylko Ty będziesz mieć dostęp. + + [*= Tylko ci, którym jawnie zezwalasz ] Domyślnie osoby, z którymi nie jesteś połączony i wszystkie nowe kontakty będą miały odmowę tego uprawnienia. Można robić wyjątki dla poszczególnych kanałów na ich ekranie edycji kontaktów. + + [*= Każdy w Twojej książce adresowej ] Każdy, kto nie znajduje się w Twojej książce adresowej ma odmowę dostępu, ale każdy kogo zaakceptujesz jako kontakt, uzyska zezwolenie. Jest to sposób stosowany na większości starszych platform. + + [*= Każdy na tym portalu ] Każdy, kto ma kanał w tym samym portalu co Ty, będzie miał pozwolenie. Każdemu, kto jest zarejestrowany na innym portalu, odmawia się dostępu. + + [*= Każdy w tej sieci ] Każdy w sieci $Projectname będzie miał zatwierdzone to pozwolenie. Nawet zupełnie obce osoby. Jednak każdemu, kto nie jest zalogowany (uwierzytelniony), tego dostępu się odmiawia. + + [*= Każdy uwierzytelniony ] Jest to podobne do uprawnienia "każdy w tej sieci", z tym wyjątkiem, że może obejmować każdego, kto może uwierzytelnić się w jakikolwiek sposób - a zatem może obejmować odwiedzających z innych sieci. + + [*= Token dostępu gościa] Umożliwia to udostępnianie pliku, folderu, zdjęcia, albumu lub kanału określonej osobie lub grupie osób. Nie muszą być członkami Hubzilli. Możesz ustawić ważność tokenu dostępu. + + [*= Każdy w Internecie ] Element jest całkowicie publiczny. To pozwolenie umożliwia dostęp każdemu. +[/dl] +[*= Indywidualne uprawnienia, to:] +[dl terms="i"] + [*= Można wyświetlać mój "publiczny" strumień i wpisy. ] To uprawnienie określa, kto może oglądać "strumień" Twojego kanału, czyli nieprywatne wpisy, które pojawiają się na karcie "Strona główna", gdy jesteś zalogowany. + + [*= Można wyświetlać mój "publiczny" profil kanału. ] To uprawnienie określa, kto może wyświetlać profil Twojego kanału. Dotyczy to zakładki "o mnie". + + [*= Można wyświetlać moje "publiczne" albumy zdjęć. ] To uprawnienie określa, kto może wyświetlać Twoje albumy ze zdjęciami. Poszczególne zdjęcia mogą nadal być publikowane do bardziej prywatnej grupy osób. + + [*= Można wyświetlać moją "publiczną" książkę adresową. ] To uprawnienie określa, kto może wyświetlać Twoje kontakty. Są to połączenia wyświetlane w sekcji "Wyświetl połączenia". + + [*= Można wyświetlać mój "publiczny" magazyn plików. ] To uprawnienie określa, kto może wyświetlać Twoje publiczne pliki przechowywane w "chmurze" serwisu. + + [*= Można wyświetlać moje "publiczne" strony. ] To uprawnienie określa, kto może wyświetlać Twoje publiczne strony internetowe. + + [*= Można przesyłać mi strumień ich kanału i wpisy. ] To uprawnienie określa, czyje wpisy będą wyświetlane na Twoim kanale. Jeśli Twój kanał jest kanałem osobistym (tj. Ty jako osoba), prawdopodobnie chciałbyś ustawić to przynajmniej tak, że "każdy z mojej książki adresowej". Osobisty kanał notatek prawdopodobnie chciałbyś ustawić na "nikt oprócz mnie". Ustawienie tego na "każdy w sieci” spowoduje wyświetlenie wpisów od zupełnie obcych osób, co jest dobrą formą rozeznania sieci. + + [*= Można publikować na stronie mojego kanału ("ścianie"). ] To uprawnienie określa, kto może umieszczać swoje wpisy na Twojej ścianie po przejściu do Twojego kanału. + + [*= Można komentować moje wpisy. ] To uprawnienie określa, kto może komentować wpisy, które tworzysz. Zwykle chce się, aby pasowało to do uprawnienia "można wyświetlać mój publiczny strumień i wpisy”. + + [*= Można wysyłać mi prywatne wiadomości pocztowe. ] Określa to, kto może wysyłać Ci prywatne wiadomości (zotmail). + + [*= Można publikować zdjęcia w moich albumach ze zdjęciami. ] To określa, kto może publikować zdjęcia w Twoich albumach. Jest to bardzo przydatne w przypadku kanałów przypominających forum, na których połączenia mogą nie być ze sobą połączone. + + [*= Można przekazywać dalej do wszystkich kontaktów z mojego kanału za pomocą tagów "post". ] Użycie wzmianek (@-) spowoduje odtworzenie kopii twojego wpisu na określonym profilu, tak jakbyś opublikował go na ścianie kanału. To ustawienie określa, czy jakieś osoby mogą w ten sposób publikować na Twoim kanale. + + [*= Można ze mną rozmawiać (jeśli jestem dostępny). ] Określa to, kto może dołączyć do publicznych czatów utworzonych na Twoim kanale. + + [*= Można zapisywać w moim "publicznym" magazynie plików. ] To określa, kto może przesyłać pliki do Twojego publicznego magazynu plików. + + [*= Można edytować moje "publiczne" strony. ] Określa to, kto może edytować Twoje strony internetowe. Jest to przydatne w przypadku witryn typu wiki lub witryn z wieloma redaktorami. + + [*= Można zarządzać zasobami mojego kanału. ] To określa, kto może mieć pełną kontrolę nad Twoim kanałem. Zwykle powinno być to ustawione na "nikt oprócz mnie". +[/dl][/dl] +[i]Uwaga:[/i] +Wtyczki (dodatki) mogą zapewniać specjalne ustawienia uprawnień, więc możesz otrzymać dodatkowe ustawienia uprawnień wykraczające poza to, co opisano tutaj. + +Jeśli ustawisz którekolwiek z tych uprawnień na "tylko te, na które wyraźnie zezwalam", możesz określać indywidualne uprawnienia na ekranie edycji połączenia. + +[h4][b]Zaprzyjaźnienie[/b][/h4] + +Ekran edycji połączenia oferuje suwak do wyboru stopnia "zaprzyjaźnienia" z połączeniem (to narzędzie można włączyć na karcie "Dodatkowe funkcje" na stronie "Ustawienia"). Potraktuj to jako miarę tego, jak bardzo ich lubisz lub nie lubisz. Wartość 1 jest dla osób, które lubisz, których wpisy chcesz widzieć cały czas; 99 jest dla osób, na których Ci nie zależy i których wpisy możesz chcieć przeglądać tylko od czasu do czasu. Po przypisaniu tutaj wartości możesz użyć narzędzia zaprzyjażnienia na stronie matrycy do filtrowania treści na podstawie tej liczby. + +Suwak na stronie matrycy ma zarówno wartość minimalną, jak i maksymalną. Wpisy będą wyświetlane tylko od osób mieszczących się w tym zakresie. Zaprzyjaźnienie nie ma związku z uprawnieniami i jest przydatna tylko w połączeniu z funkcją narzędzia zaprzyjaźnienia. + +[h3]Tokeny dostępu gościa[/h3] +Tokeny dostępu gościa (czasami nazywane "tokenami dostępu Zot") umożliwiają udostępnianie pliku, folderu, zdjęcia, albumu lub kanału określonej osobie lub grupie osób, które nie są członkami portalu Hubzilli. Te tokeny umożliwiają udostępnianie poszczególnych elementów poprzez wysłanie linku zawierającego token w adresie URL; alternatywnie, osoby mogą faktycznie logować się przy użyciu poświadczeń tokena, po czym mogą bezproblemowo przeglądać zawartość udostępnioną temu tokenowi. + +W celu utworzenia tokenów dostępu gościa i zarządzać nimi, otwórz stronę ustawień "Tokeny dostępu gościa". Przy każdym załadowaniu strony generowany jest losowy token, który umożliwia utworzenie specjalnego adresu URL zawierającego ten token i opcjonalnie określenie daty wygaśnięcia. Istniejące tokeny są wymienione poniżej okna dialogowego i można je edytować, wybierać lub usuwać. + +Tokenowi gościa można przyznać dodatkowe uprawnienia, rozszerzając opcje "Indywidualnych uprawnień" i wybierając ustawienia prywatności, takie jak "Może wyświetlać strumień i wpisy mojego kanału" lub "Może rozmawiać ze mną". + +[url=[baseurl]/help/feature/access_tokens]Więcej informacji...[/url] + +[img][baseurl]/doc/member/assets/zat_dialog.png[/img] + +[h3]Język znaczników[/h3] +$Projectname obsługuje kilka języków znaczników do zaawansowanego formatowania treści. Domyślnym językiem znaczników jest [url=[baseurl]/help/pl/member/bbcode]własny wariant BBcode[/url], dostosowany do użytku w Hubzilli. BBcode jest obsługiwany dla wpisów, stron wiki i elementów stron internetowych. Strony Wiki i elementy stron internetowych można również pisać przy użyciu standardowego języka Markdown. +[table border=0] +[tr][th]Typ treści[/th][th]Obsługiwany język[/th][/tr] +[tr][td]Wpis[/td][td][url=[baseurl]/help/pl/member/bbcode]BBcode[/url][/td][/tr] +[tr][td]Wiki[/td][td][url=[baseurl]/help/pl/member/bbcode]BBcode[/url], Markdown[/td][/tr] +[tr][td]Elementy stron WWW[/td][td][url=[baseurl]/help/pl/member/bbcode]BBcode[/url], Markdown, HTML[/td][/tr] +[/table] + +[h3]Tagi i wzmianki[/h3] +Podobnie jak wiele innych platform, $Projectname używa specjalnej notacji wewnątrz wiadomości, aby wskazać "tagi" lub powiązania kontekstowe z innymi podmiotami. + +[h4][b]Wzmianki[/b][/h4] +Kanały (profile) są oznaczane przez swoją nazwę poprzedzoną znakiem ed, np. [code]@Jacek[/code]. Jest to wykorzystywane w mechaniźmie wzmianek. + +Kiedy zaczniesz zmiankować o kimś w swoim wpisie (wstawiając znak @), mechanizm ten utworzy pole z autouzupełnianiem, aby można było wybrać z Twoich bezpośrednich kontaktów określoną osobę (kanał). Możesz wybrać z listy kanał, który chcesz wzmiankować. + +Jeśli wspomniana osoba znajduje się na liście odbiorców wpisu, otrzyma powiadomienie o tym znaczniku. + +[h4][b]Wzmianki dostarczania[/b][/h4] + +Znak wykrzyknika ([b]![/b]) oznacza [i]wzmiankę dostarczania[/i] wstawioną na forum lub specjalnym kanale, która umożliwia rozesłanie wisu do wielu odbiorców. + +[code] +@Gardening - wzmiankowanie forum Gardening + +!Gardening - wzmiankowanie forum Gardening i równoczesne opublikowanie wpisu w "sieci" Gardening " (np. rozesłanie wpisu do wszystkich członków tej sieci, jeśli ma się na to pozwolenie). +[/code] + +Uwaga: w poprzednich wersjach, format wzmianki dostarczania miał wpisuć [code]@forum+[.code] (plus na końcu). Ten mechanizm nie jest już obsługiwany. + +[h4][b]Wzmianki prywatności[/b][/h4] +Jeśli chcesz ograniczyć wpis do jednej osoby lub kilku osób, możesz to zrobić, wybierając kanały lub grupy prywatności w narzędziu do ochrony prywatności. Możesz także po prostu oznaczyć je tagiem prywatności. Znacznik prywatności to nazwa poprzedzona znakami [code]@![/code], co zmienia również uprawnienia prywatności wpisu, tak aby zawierały tylko te osoby, którym chcesz dostarczyć wpis. Można wstawić więcej niż jeden tag prywatności, na przykład tagi [code]@!Bob[/code] i [code]@!Linda[/code] sposowdują wysłanie wpisu tylko do Boba i Lindy. Ten mechanizm zastępuje selektor prywatności. + +Fora mogą być wzmiankowane w ten sam sposób. Wzmianka [code]!!dogs[/code] będzie powodować publikowanie prywatnie na forum "dogs". Forum ponownie dostarczy wpis do wszystkich członków forum, ale Twoi obserwatorzy nie zobaczą go, chyba że są również członkami forum "dogs". + +Można także oznaczyć grupy prywatności, które są "publiczne". Gdy tworzysz lub edytujesz grupę prywatności, jest dostępne pole wyboru, które umożliwia innym osobom zobaczenie członków grupy. Jeśli to pole jest zaznaczone dla grupy i oznaczysz wpis, na przykład tagiem [code]@!Friends[/code] - zostanie on ograniczony do grupy Friends. Zanim to zrobisz, sprawdź, czy grupa jest publiczna, ponieważ nie ma innego sposobu na wycofanie wpisu niz jego usunięcie. Nazwa grupy pojawi się w poście i powiadomi członków tej grupy, że są jej członkami. + +[h4][b]Wzmianki a komentarze[/b][/h4] +Powyższe mechanizmy mają zastosowanie tylko do wpisów "najwyższego poziomu". Wzmianka o kanale z którymkolwiek z powyższych mechanizmów nie ma wpływu na komentarze, poza tym, że wzmiankowany kanał może otrzymać powiadomienie, jeśli był już uwzględniony w rozmowie jako odbiorca. + +[h4][b]Tagi tematyczne (hasztagi)[/b][/h4] +[i]Tagi tematyczne[/i], zwane też [i]hasztagami[/i], mają format terminu poprzedzonego znakiem hash ([b]#[/b]). Powoduje to utworzenie w poście łącza do ogólnoserwisowego wyszukiwania podanego terminu. Na przykład, [code]#cars[/code] zapewni link do wyszukiwania dla wszystkich wpisów zawierających słowo kluczowe [code]cars[/code] w Twoim serwisie. W tagach tematycznych powinno się używać terminów nie krótszych niż trzy znaki. Krótsze terminy wyszukiwania prawdopodobnie nie przyniosą żadnych wyników wyszukiwania, chociaż zależy to od konfiguracji bazy danych. + +Tagi tematyczne zawierające same cyfry nie są zwykle dozwolone, np. [code]#1[/code]. Jeśli chcesz użyć hashtagu numerycznego, dodaj tekst opisowy, np. [code]#2012-wybory[/code] lub umieść cały termin w podwójnych cudzysłowach (na przykład [code]#"2012"[/code]). Podwójne cudzysłowy są również wymagane, jeśli termin zawiera spacje ([code]#"My tag[/code]`) i mogą być wymagane, jeśli tag zawiera znaki interpunkcyjne lub znaki diakrytyczne ([code]#"EndsWithPeriod."[/code], [code]#"Exciting!!!"[/code], [code]#"Ósmy pasażer"[/code] itp.). + +[h4][b]Zakładki[/b][/h4] +Zakładki wskazują link, który można zapisać w folderze zakładek. Używają sekwencji [code]#^[/code], po której następuje link. Często są one generowane automatycznie. Jeśli zainstalowany jest dodatek "bookmarker", sekwencja ta zostanie przekonwertowana na ikonę zakładki podczas przeglądania inline wpisu lub komentarza, a kliknięcie ikony spowoduje zapisanie zakładki. Jeśli dodatek bookmarker nie jest zainstalowany, można wykorzystać rozwijane menu wpisu, które zawiera łącze do zapisania zakładki lub zakładek. + +[h4][b]Ręczne wzmiankowanie[/b][/h4] +Na przykład, tag [code]@billy[/code] oznaczy połączenie, którego nazwa lub adres sieciowy to "billy" (dopasowanie dokładne). Jeśli masz dwa połączenia z nazwą lub adresem sieciowym billy, na przykład [code]billy@server1.hubzilla.org[/code] i [code]billy@server2.hubzilla2.org[/code], będziesz musiał podać pełny adres, inaczej wyniki będą niejednoznaczne i niewłaściwa osoba może zostać oznaczona. + +Tag [code]@"Robert Johnson"[/code] oznaczy Roberta Johnsona. Podwójne cudzysłowy są wymagane, jeśli oznaczona nazwa zawiera spacje. + +[h3]Strony internetowe[/h3] + +$Projectname umożliwia członkom i dozwolonym połączeniom tworzenie statycznych stron internetowych. Aby aktywować tę funkcję, włącz funkcję [b]Strony internetowe[/b] w sekcji [b][url=[baseurl]/settings/features/]Dodatkowe funkcjonalności[/url][/b]. + +Po włączeniu, na stronie kanału pojawi się nowa karta zatytułowana "Strony internetowe". Kliknięcie tego linku przeniesie Cię do edytora stron internetowych. Strony będą dostępne pod adresem [b][baseurl]/page/[observer=1][observer.webname][/observer][observer=0]channelname[/observer]/pagelinktitle[/b] + +Pole "Tytuł linku do strony" umożliwia określenie tytułu linku do strony tego adresu URL. Jeśli tytuł linku do strony nie jest ustawiony, ustawimy go automatycznie, używając identyfikatora wiadomości elementu. + +Pod polem tworzenia strony pojawi się lista istniejących stron z linkiem "Edytuj". Kliknięcie tego przeniesie Cię do edytora podobnego do edytora wpisów, w którym możesz wprowadzać zmiany na swoich stronach internetowych. + +[h4][b]Używanie bloków[/b][/h4] + +Bloki mogą być częściami stron internetowych. Podstawowy kod HTML bloku wygląda następująco: +[code] + <div> + Block Content + </div> + +[/code] + +Jeśli blok ma zawartość tekstową (html), może również zawierać elementy menu. Na przykład, zawartość: +[code] + <p>HTML block content</p> + [menu]menuname[/menu] + +[/code] +wytworzy HTML taki jak ten: +[code] + <div> + <p>HTML block content</p> + <div> + <ul> + <li><a href="#">Link 1</a></li> + <li><a href="#">Link 2</a></li> + <li><a href="#">Link 3</a></li> + </ul> + </div> + </div> + +[/code] + +Makro [code]$content[/code] umożliwia osadzenie całej treści strony internetowej. W tym celu wystarczy utwórzyć taki blok: +[code] + $content + +[/code] +jako treść. Aby blok pojawił się na stronie internetowej, musi być zdefiniowany w układzie strony wewnątrz regionu. +[code] + [region=aside] + [block]blockname[/block] + [/region] + +[/code] + +Wygląd bloku można zmieniać w układzie strony. + +W regionie można przypisać własne klasy (css). Ten kod: +[code] + [region=aside] + [block=myclass]blockname[/block] + [/region] + +[/code] +wytworzy taki HTML: +[code] + <div class="myclass"> + Block Content + </div> + +[/code] + +Za pomocą zmiennej [code]wrap[/code] z bloku można usunąć otaczające go znaczniki [code]<div> </div>[/code]. Ten kod: +[code] + [region=aside] + [block][var=wrap]none[/var]blockname[/block] + [/region] + +[/code] +wytworzy taki HTML: +[code] + Treść bloku +[/code] + +[h4][b]Narzędzie importy elementów strony internetowej[/b][/h4] + +Istnieją dwie metody importowania elementów strony internetowej: przesyłanie pliku ZIP lub odwoływanie się do plików we własnym magazynu plików w serwisie. Obie metody wymagają określenia elementów strony sieci internetowej przy użyciu określonej struktury folderów. Narzędzie importu umożliwia zaimportowanie wszystkich elementów niezbędnych do zbudowania całej witryny lub zestawu witryn. Celem jest uwzględnienie zewnętrznego tworzenia stron internetowych, a także narzędzi upraszczających i automatyzujących wdrażanie na portalu. + +[h5][b] Struktura folderu [/b][/h5] +Definicje elementów muszą być przechowywane w katalogu głównym repozytorium w folderach o nazwie odpowiadającej typowi elementu: +[code] + /pages/ + /blocks/ + /layouts/ +[/code] + +Każdy element tych typów musi być zdefiniowany w osobnym podfolderze przy użyciu dwóch plików: jednego w formacie JSON dla metadanych i drugiego w zwykłym formacie testowym dla zawartości elementu. + +[h5][b] Elementy strony [/b][/h5] +Metadane elementu strony są zdefiniowane w pliku w formacie JSON o nazwie [code]strona.json[/code] z następującymi właściwościami: +[list] +[*] title +[*] pagelink +[*] mimetype +[*] layout +[*] contentfile +[/list] +[b]Przykład[/b] + +Pliki: +[code] + /pages/my-page/page.json + /pages/my-page/my-page.bbcode +[/code] +Treść [code]page.json[/code]: +[code] + { + "title": "My Page", + "pagelink": "mypage", + "mimetype": "text/bbcode", + "layout": "my-layout", + "contentfile": "my-page.bbcode" + } +[/code] +[h5][b] Elementy układu [/b][/h5] + +Metadane elementu układu są zdefiniowane w pliku w formacie JSON o nazwie [code]layout.json[/code] z następującymi właściwościami: +[list] +[*] name +[*] description +[*] contentfile +[/list] +[b]Przykład[/b] + +Pliki: +[code] + /layouts/my-layout/layout.json + /layouts/my-layout/my-layout.bbcode +[/code] +Treść [code]layout.json[/code]: +[code] + { + "name": "my-layout", + "description": "Layout for my project page", + "contentfile": "my-layout.bbcode" + } +[/code] + +[h5][b] Elementy bloku [/b][/h5] + +Metadane elementu bloku są określone w pliku w formacie JSON o nazwie [code]block.json[/code] z następującymi właściwościami: +[list] +[*] name +[*] title +[*] mimetype +[*] contentfile +[/list] +[b]Przykład[/b] + +Pliki: +[code] + /blocks/my-block/block.json + /blocks/my-block/my-block.html +[/code] +Treść [code]block.json[/code]: + +[code] + { + "name": "my-block", + "title": "", + "mimetype": "text/html", + "contentfile": "my-block.html" + } +[/code] + +[h3]Język opisu stron Comanche[/h3] + +Comanche to język znaczników podobny do [url=[baseurl]/help/member/bbcode]BBcode[/url], za pomocą którego można tworzyć rozbudowane i złożone strony internetowe, łącząc je z szeregu komponentów - z których niektóre są już wstępnie zbudowane i inne, które można skonstruować w locie. Comanche używa własnego języka opisu strony do tworzenia tych stron. + +Comanche przede wszystkim wybiera, jakie treści pojawią się w różnych [b]regionach[/b] strony. Regiony mają swoje nazwy, które mogą się zmieniać w zależności od wybranego szablonu układu. + +[h4][b]Szablony strony[/b][/h4] +Obecnie dostępnych jest pięć szablonów układów, ale w serwisie można udostępniać dodatkowe, własne układy. + +[dl terms="b"] +[*= default] +Domyślny szablon zawiera definicję regionu "nav" znajdującego się u góry, "aside" jako pasek boczny o stałej szerokości, +"content" dla głównego regionu treści i "footer" dla stopki strony. + +[*= full] +Pełny szablon definiuje to samo, co szablon "default", z tą różnicą, że nie ma regionu "aside". + +[*= choklet] +Szablon "choklet" zapewnia kilka płynnych układów, które można wybierać według odmiany: +[list] +[*] (domyślna odmiana) - układ dwukolumnowy, podobny do szaablonu "default", ale jest bardziej płynny +[*] bannertwo - układ dwukolumnowy z regionem "banner", zgodny z szablonem "default" na małych wyświetlaczach +[*] three - układ trzykolumnowy (dodany region "right_aside" do szablonu domyślnego) +[*] edgestwo - układ dwukolumnowy ze stałymi marginesami bocznymi +[*] edgesthree - układ trzykolumnowy ze stałymi marginesami bocznymi +[*] full - układ trzykolumnowy ze stałymi marginesami bocznymi i dodanym obszarem "header" poniżej paska nawigacji +[/list] + +[*= redable] +Szablon do czytania dłuższych tekstów na pełnym ekranie (czyli bez paska nawigacyjnego). Trzy kolumny: "aside", "content" i "right_aside". +Aby zapewnić maksymalną czytelność, zaleca się używanie tylko środkowej kolumny treści. + +[*= zen] +Daje swobodę robienia wszystkiego samemu. Tylko pusta strona z obszarem zawartości. +[/dl] + +Aby wybrać szablon układu, trzeba użyć tagu "template". + +[code] + [template]full[/template] + +[/code] + +Wybranie szablonu "choklet" z odmianą "three": + +[code] + [template=three]choklet[/template] + +[/code] + +Jeśli nie określono innego szablonu, zostanie użyty szablon domyślny. W szablonie można używać dowolnych nazw dla regionów zawartości. Używa sie też tagów "region", aby zdecydować, jakie treści umieścić w odpowiednich regionach. + +Zadefiniowane są też trzy "makra", które można użyć na stronie. +[code] + $htmlhead - wstawia zawartość nagłówka strony. + $nav - wstawia zawartość paska nawigacji. + $content - wstawia główną treść strony. + +[/code] + +Domyślnie, makro $nav jest umieszczane w regionie "nav" strony a $content w regionie "content". Tych makr potrzebujesz tylko wtedy, gdy chcesz zmienić rozmieszczenie tych elementów, aby zmienić kolejność lub przenieść je do innych regionów. + +Aby wybrać motyw dla swojej strony, użyj tagu "theme". +[code] + [theme]suckerberg[/theme] + +[/code] +Spowoduje to wybranie motywu o nazwie "suckerberg". Domyślnie używany jest preferowany motyw Twojego kanału. + +[code] + [theme=passion]suckerberg[/theme] + +[/code] +Spowoduje to wybranie motywu o nazwie "suckerberg" oraz wybór schematu "passion" (wariant motywu). Alternatywnie można użyć do tego zwięzłej notacji motywu. + +[code] + [theme]suckerberg:passion[/theme] + +[/code] + +Notacja zwięzła nie jest częścią samego Comanche, ale jest rozpoznawana przez platformę $Projectname jako specyfikator motywu. + +[h4][b]Pasek nawigacji[/b][/h4] + +[code] + [navbar]tucson[/navbar] +[/code] + +Kod ten powoduje użycie szablonu paska nawigacyjnego "tucson" i reguł CSS. Domyślnie stosowany jest szablon domyślny szablon paska nawigacyjnego. + +[h4][b]Regiony[/b][/h4] +Tak jak wspomniano wyżej, każdy region swoją nazwę. Wybrany eegion określa używając tagu "region", który zawiera nazwę. Wszelkie treści, które chcesz umieścić w tym regionie, powinny być umieszczone między tagiem otwierającego a zamykającym. + +[code] + [region=htmlhead]....tutaj jest treść....[/region] + [region=aside]....tutaj jest treść....[/region] + [region=nav]....tutaj jest treść....[/region] + [region=content]....tutaj jest treść....[/region] + +[/code] + +[h4][b]CSS i Javascript[/b][/h4] +Jest możliwość włączenia bibliotek JavaScript i CSS w regionie "htmlhead". Obecnie korzystamy z bibliotek jQuery (JS), Bootstrap (CSS i JS) oraz Foundation (CSS i JS). +Ten kod spowoduje nadpisanie regionu htmlhead wybranego motywu. + +[code] + [region=htmlhead] + [css]bootstrap[/css] + [js]jquery[/js] + [js]bootstrap[/js] + [/region] + +[/code] + +[h4][b]Elementy menu i bloki[/b][/h4] +Narzędzia do tworzenia stron internetowych umożliwiają również tworzenie eleentów menu i bloków. Dostarczają one fragment kodu, który można umieścić w dowolnych regionach i w dowolnej kolejności. Każdy z takich fragmentów ma nazwę, którą definiuje się podczas tworzenia elementów menu lub bloku. + +Ten kod: +[code] + [menu]mymenu[/menu] + +[/code] +spowoduje umieszczenie w tym miejscu menu o nazwie "mymenu”, ale miejsce to musi się ono znajdować wewnątrz regionu. + +Kod: +[code] + [menu=horizontal]mymenu[/menu] + +[/code] +spowoduje umieszczenie w tym miejscu menu o nazwie "mymenu", ale musi się ono znajdować które musi znajdować wewnątrz regionu. Dodatkowo zastosowano tu do menu klasę "horizontal". Klasa "horizontal" jest zdefiniowana w motwie "redbasic". Może być dostępna lub nie w innych motywach. + +W tym bloku: +[code] + [menu][var=wrap]none[/var]mymenu[/menu] + +[/code] +zmienna [code][var=wrap]none[/var][/code] usuwa z menu element [code]div[/code]. + +Ten kod: +[code] + [block]contributors[/block] +[/code] +umieszcza blok o nazwie "contributors" w regionie, w którym został wstawiony. + +Kod: +[code] + [block=someclass]contributors[/block] + +[/code] +też umieszcza blok o nazwie "contributors" w tym regionie, ale dodatkowo stosuje dla tego bloku klasę "someclass". Zamienia to domyślną klasę bloku "bblock widget". + +W bloku: +[code] + [block][var=wrap]none[/var]contributors[/block] + +[/code] +zmienna [code][var=wrap]none[/var][/code] usuwa z bloku opakowujący go element [code]div[/code]. + +[h4][b]Widżety[/b][/h4] +Widżety to wykonywalne aplikacje dostarczane przez system, które można umieścić na swojej stronie. Niektóre widżety przyjmują argumenty, które pozwalają dostosować widżet do własnych potrzeb. Widżety systemowe są wymienione [url=help/Widgets]tutaj[/url]. Widżety mogą być również tworzone w ramach wtyczek, motywów lub przez administratora witryny, aby zapewnić dodatkowe funkcje. + +Widżety i ich argumenty są określane za pomocą tagów "widget" i "var". +[code] + [widget=recent_visitors][var=count]24[/var][/widget] + +[/code] + +Spowoduje to załadowanie widżetu „latest_visitors” i dostarcza mu argument "count" ustawiony na „24”. + +[h4][b]Komentarze[/b][/h4] +Tag "comment" jest używany do wydzielenia komentarzy. Komentarze te nie pojawią się na renderowanej stronie. + +[code] + [comment]This is a comment[/comment] + +[/code] + +[h4][b]Wykonanie warunkowe[/b][/h4] +Można użyć konstrukcji [code]if[/code] warunkowego wykonania kodu. Jest to obecnie oparte na zmiennej konfiguracji systemu [code]$config.system[/code] lub zmiennej [code]$observer[/code]. + +[code] + [if $config.system.foo] + ... zmienna konfiguracyjna system.foo przyjmuje wartość 'true'. + [else] + ... zmienna konfiguracyjna system.foo przyjmuje wartość 'false'. + [/if] + + [if $observer] + ... ta treść będzie pokazywana tylko uwierzytelnionym użytownikom + [/if] + +[/code] + + Klauzula 'else' jest opcjonalna. + + Oprócz oceny logicznej obsługiwanych jest też kilka testów. + +[code] + [if $config.system.foo == bar] + ... zmienna konfiguracyjne system.foo jest równa łańcuchowi 'bar' + [/if] + [if $config.system.foo != bar] + ... zmienna konfiguracyjne system.foo nie jest równa łańcuchowi 'bar' + [/if] + [if $config.system.foo {} bar ] + ... zmienna konfiguracyjna system.foo jest prostą tablicą zawierającą zmienną 'bar' + [/if] + [if $config.system.foo {*} bar] + ... zmienna konfiguracyjna system.foo jest prostą tablicą zawierającą klucz o nazwie 'bar' + [/if] +[/code] + +[h4][b]Złożony przykład[/b][/h4] +[code] + [comment]użyj istniejący szablon strony, który zawiera obszar banera oraz 3 kolumny poniżej[/comment] + + [template]3-column-with-header[/template] + + [comment]Użyj motyw "darknight"[/comment] + + [theme]darkknight[/theme] + + [comment]Użyj istniejące menu nawigacyjne strony[/comment] + + [region=nav]$nav[/region] + + [region=side] + + [comment]Użyj wybranego przeze mnie menu i kilku widżetów[/comment] + + [menu]myfavouritemenu[/menu] + + [widget=recent_visitors] + [var=count]24[/var] + [var=names_only]1[/var] + [/widget] + + [widget=tagcloud][/widget] + [block]donate[/block] + + [/region] + + + + [region=middle] + + [comment]Pokaż normalną zawartość strony[/comment] + + $content + + [/region] + + + + [region=right] + + [comment]Pokaż mój skondensowany kanał RSS "wal" i zezwól na interakcję, jeśli obserwator ma możliwość interakcji[/comment] + + [widget]channel[/widget] + + [/region] + +[/code] + + +[h3]Osobisty magazyn plików[/h3] + +$Projectname umożliwia prywatne przechowywanie i udostępnianie znajomym dowolnych plików. Możesz przesłać pliki ze swojego komputera do obszaru przechowywania lub skopiować je bezpośrednio z systemu operacyjnego przy użyciu protokołu WebDAV. + +Funkcjonuje to podobnie do usług "chmurowych", takich jak [i]Dopbox[/i], [i]Dysk[/i] Google czy [i]One Drive[/i] Microsoftu. + +Na wielu serwerach publicznych mogą obowiązywać ograniczenia dotyczące przydzielonej powierzchni dyskowej. + +[h4][b]Załączniki plikowe[/b][/h4] + +Najszybszym i najłatwiejszym sposobem udostępniania plików są załączniki. W rzędzie ikon poniżej edytora statusu znajduje się narzędzie do przesyłania załączników. Kliknij narzędzie, wybierz plik i prześlij. Po załadowaniu pliku zobaczysz kod załącznika umieszczony w obszarze tekstowym. Nie edytuj tego kodu, ponieważ może to uniemożliwić Ci udostępnienie tego pliku znajomym. Możesz użyć okna dialogowego uprawnień do publikowania lub hasztagów prywatności, aby ograniczyć widoczność pliku - który zostanie ustawiony zgodnie z uprawnieniami wysyłanego wpisu. + +Aby usunąć załączniki lub zmienić uprawnienia do przechowywanych plików, odwiedź [observer=1][baseurl]/cloud/[observer.webname][/observer][observer=0][baseurl]/cloud/username, zastępując [code]username[/code] pseudonimem, jaki podałeś podczas tworzenia kanału[/observer]. + +[h4][b]Dostęp internetowy[/b][/h4] + +Twoje pliki są widoczne w sieci pod adresem [observer=1][baseurl]/cloud/[observer.webname][/observer][observer=0][baseurl]/cloud/username[/observer] dla każdego, kto ma uprawnienia do ich przeglądania. Jeśli przeglądający ma wystarczające uprawnienia, może mieć również możliwość tworzenia nowych plików i folderów (katalogów) w interfejsie przeglądarki. Dostęp internetowy powinnien być używane tylko w przypadku mniejszych plików i zdjęć (do kilku megabajtów), ponieważ wykorzystuje pamięć wewnętrzną. W przypadku większych plików (filmy, muzyka itp.) przesyłaj je za pomocą protokołu WebDAV, cojest omówione w następnym rozdziale. Takie pliki będzie można nadal pobierać za pośrednictwem dostępu internetowego. + +[h4][b]Dostęp WebDAV[/b][/h4] + +WebDAV umożliwia kopiowanie plików bezpośrednio do lub z systemu operacyjnego komputera, gdzie Twój "magazyn plików" pojawia się jako wirtualny dysk. Dostęp ten powinien być używany do przesyłania dużych plików, takich jak wideo i audio, ponieważ nie jest ograniczony dostępną pamięcią wewnętrzna. Zobacz [zrl=help/member/member_guide#Cloud_Desktop_Clients]Cloud Desktop Clients[/zrl] poniżej. + +[h4][b]Dostęp CalDAV i CardDAV na Androidzie[/b][/h4] + +Możesz zsynchronizować swój kalendarz i kontakty w systemie Android ze swoim portalem. + +Poniższe kroki zostały przetestowane pod kątem zasosowania [url=https://f-droid.org/en/packages/at.bitfire.davdroid/] DAVdroid [/url]: + +[list] +[*] zainstaluj DAVdroid +[*] dodaj konto +[*] użyj "URL" i "user name" do zalogowania się +[list] +[*] podstawowy URL to [baseurl]/cdav +[*] Twoja nazwa użytkowka to [observer=1][observer.webname][/observer][observer=0]username[/observer] +[/list] +[/list] + +Aby udostępnić kalendarz odwiedź [observer.baseurl]/cdav/calendar + +[h4][b]Uprawnienia[/b][/h4] + +W przypadku korzystania z protokołu WebDAV plik jest tworzony z domyślnymi uprawnieniami do plików kanału, których nie można zmienić z poziomu systemu operacyjnego. Może też nie być to tak restrykcyjne, jak byś chciał. Najlepiej, utwórz foldery (katalogi), następnie odwiedź swój magazyn plików pod adresem [observer=1][baseurl]/cloud/[observer.webname][/observer][observer=0][baseurl]/cloud/username[/observer], wybierz katalog i zmień uprawnienia. Zrób to zanim umieścisz cokolwiek w katalogu. Uprawnienia do katalogu mają pierwszeństwo, więc możesz następnie umieścić pliki lub inne foldery w tym kontenerze i będą one chronione przed niechcianymi widzami przez ustawienie uprawnienia do katalogu. Często zdarza się, że użytkownicy tworzą folder "osobisty" lub "prywatny", który jest ograniczony do nich samych. Możesz używać tego jako osobistej chmury do przechowywania wszystkiego z dowolnego miejsca w Internecie lub dowolnego komputera i jest to chroniony przed innymi. Możesz także utworzyć foldery dla "rodziny" lub "przyjaciele" za zgodą udzieloną odpowiednim grupom prywatności. + +[h3]Klienty desktopowe dla magazynu plikowego[/h3] + +[h4][b]Klienty dla Windows[/b][/h4] + +W Windows 7 połaczenie WebDAV można nawiązać przy użyciu kreatora z graficznym interfejsem: +1. Kliknij lewym przyciskiem myszy na przycisk "Start", aby otworzyc menu "Start". +2. Kliknij prawym przyciskiem myszy na ikone "Mój komputer", aby uzyskac dostęp do tego menu. +3. Kliknij lewym przysiskiem myszy na link "Mapuj dysk sieciowy...", aby otworzyć okno dialogowe kreatora połączeń. +4. Wpisz '[baseurl]/dav/nickname' w polu tekstowym (zamieniając 'nickname' na pseudonim swojego kanału) i kliknij przycisk "Gotowe". +5. Wpisz pseudonim kanału $Projectname. WAŻNE - bez znaku @ lub nazwy domeny +6. Wpisz swoje hasło $Projectname + +[h4][b]Klienty dla Linux[/b][/h4] + +[h5][b]Montowanie katalogu w systemie plików[/b][/h5] + +Aby zainstalować katalog zdalny jako system plików, musisz najpierw zainstalować davfs2. Dla większości dystrybucji program ten jest dostępny w repozytoriach. Instalacja w Debianie: + +[code]sudo apt-get install davfs2[/code] + +Następnie skonfiguruj davfs2: + +[code]sudo dpkg-reconfigure davfs2[/code] + +i wybierz "yes" przy zapytaniu. + +Teraz musisz dodać użytkownika, który ma mieć możliwość montowania dav, do grupy davfs2: + +[code]sudo usermod -aG davfs2 <DesktopUser>[/code] + +[b]Note:[/b] w niektórych systemach grupa użytkowników może być inna, +np. "network" w Arch Linux. W razie wątpliwości sprawdź dokumentację +davfs dla swojego konkretnego systemu operacyjnego. + +Edytuj /etc/fstab: + +[code]nano /etc/fstab[/code] + +aby uwzględnić katalog zdalny, dodając: + +[code] +[baseurl]/dav/ /mount/point davfs user,noauto,uid=<DesktopUser>,file_mode=600,dir_mode=700 0 1 +[/code] + +gdzie [baseurl] jest adresem URL portalu, /mount/point to lokalizacja, w której chcesz zamontować katalog zdalny, a <DesktopUser> to użytkownik, którego logujesz się na swoim komputerze. Miej na uwadze, że jeśli montujesz jako zwykły użytkownik (nie root), punkt montowania musi znajdować się w twoim katalogu domowym. + +Przyjmijmy, że chcesz zamontować swój magazyn plików w katalogu o nazwie 'cloud' w swoim katalogu domowym, a Twoja nazwa użytkownika to 'bob'. Zapis w fstab będzie następujący: + +[code][baseurl]/dav/ /home/bob/cloud davfs user,noauto,uid=bob,file_mode=600,dir_mode=700 0 1[/code] + +Teraz utówrz punkt montowania: + +[code]mkdir /home/bob/cloud[/code] + +oraz utwórz plik katalogu do przechowywania danych uwierzytelniania: + +[code]mkdir /home/bob/.davfs2[/code] + +Utwórz plik o nazwie 'secrets' + +[code]nano /home/bob/.davfs2/secrets[/code] + +i dodaj tam swoje dane uwierzytelniania w katalogu zdalnym: + +[code] +[baseurl]/dav <username> <password> +[/code] + +gdzie <username> i <password> to nazwa użytkownika i hasło [i]na Twoim kanale w portalu[/i]. + +Nie pozwól, aby ten plik mógł być zapisywany przez kogoś nieupoważnionego: + +[code]chmod 600 /home/bob/.davfs2/secrets[/code] + +Na koniec, zamontuj dysk: + +[code]mount [baseurl]/dav[/code] + +Możesz teraz znaleźć swój katalog zdalny w /home/bob/cloud i używać go tak, jakby była częścią lokalnego systemu plików - nawet jeśli aplikacje, których używasz, same nie obsługują dav. + +[b]Rozwiązywanie problemów[/b] + +W przypadku niektórych serwerów WWW i pewnych konfiguracji może się okazać, że davfs2 tworzy pliki o rozmiarze pliku 0 bajtów, podczas gdy inni klienty działają dobrze. Zwykle jest to spowodowane pamięcią podręczną i blokadami. Jeśli występuje ten problem, musisz edytować konfigurację davfs2. + +[code]sudo nano /etc/davfs2/davfs2.conf[/code] + +Twoja dystrybucja dostarczy przykładową konfigurację i ten plik powinien już istnieć, jednak większość jego treści jest zakomentowana znakiem # na początku wiersza. + +Pierwszym krokiem jest usunięcie blokad. + +Edytuj wiersz use_locks, tak aby odczytywał [code]use_locks 0[/code]. + +Odłącz system plików, podłącz go ponownie i spróbuj skopiować plik z wiersza poleceń. Zauważ, że powinieneś skopiować nowy plik a nie nadpisywać starego. który został utwozony na potrzeby tego testu. Poczekaj minutę lub dwie, a następnie wykonaj polecenie [code]ls -l -h[/code] i sprawdź, czy rozmiar nowego pliku jest nadal większy niż 0 bajtów. Jeśli tak, zatrzymaj się na tym i nie rób nic więcej. + +Jeśli to nadal nie zadziała, wyłącz pamięć podręczną. Pamiętaj, że ma to wpływ na wydajność, więc należy to robić tylko wtedy, gdy wyłączenie blokad nie rozwiązało problemu. Edytuj cache_size i ustaw ją na [code]cache_size 0[/code], a także ustaw file_refresh na [code]file_refresh 0[/code]. Odmontuj system plików, ponownie go podłącz i przetestuj ponownie. + +Jeśli [i]nadal[/i] to nie działa, jest jeszcze jedna rzecz, której możesz spróbować. (Ten jest spowodowany błędem w starszych wersjach samego dav2fs, więc aktualizacja do nowej wersji może również pomóc). Włącz słabe usuwanie etagów, ustawiając [code]drop_weak_etags 1[]/code. Odmontuj i ponownie podłącz swój system plików, aby zastosować zmiany. + +[h5][b]Dolphin[/b][/h5] +Dolphin Browser to przeglądarka internetowa dla Android i iOS. Odwiedź w niej [code]webdavs://example.com/dav[/code], gdzie [code]example.com[/code] to URL do Twojego portalu. + +Gdy zostaniesz poproszony o podanie nazwy użytkownika i hasła, wprowadź nazwę swojego kanału (pierwszą część swojej strony internetowej - bez znaku @ i nazwy domeny) i hasło do swojego normalnego konta. + +Pamiętaj, że jeśli jesteś już zalogowany do interfejsu WWW przez Konqueror, nie zostaniesz poproszony o dalsze uwierzytelnianie. + +[h5][b]Konqueror[/b][/h5] +Konqueror to przeglądarka internetowa, meadżer plików i przeglądarka dokumentów dla środowiska KDE. Wystarczy odwiedzić w niej serwis [code]webdavs://example.com/dav[/code] po zalogowaniu się do swojego portalu, gdzie [code]example.com[/code] to adres URL portalu. + +Jeśli jesteś zalogowany do swojego portalu w normalny sposób, nie jest wymagane dalsze uwierzytelnianie. + +Ponadto, jeśli ktoś uwierzytelnił się w innym portalu podczas normalnej sesji przeglądarki, Twoja tożsamość zostanie również przekazana do magazynu plików dla tych portali - co oznacza, że możesz uzyskać dostęp do wszelkich prywatnych plików na dowolnym serwerze, o ile masz uprawnienia do ich przeglądania i pod warunkiem, że odwiedziłeś tę witrynę wcześniej podczas sesji. + +Ta funkcja jest zwykle ograniczona do interfejsu sieciowego i nie jest dostępna dla żadnego innego środowiska graficznego niż KDE. + +[h5][b]Nautilus[/b][/h5] + +Nautilus to popularny menadżer plików dla środowiska GNOME. Jeśli sie nią posługujesz: + +1. Otwórz okno przeglądarki plików; +2. Wybierz z menu opcję Plik > Połącz z serwerem...; +3. Wpisz davs://<domain_name>/dav/<your_channelname> i kliknij Połącz; +4. Zostaniesz poproszony o podanie nazwy kanału (tak samo jak poprzednio) i hasło; +5. Twój osobisty katalog DAV zostanie udostęþniony w oknie przeglądarki. + +[h5][b]Nemo[/b][/h5] + +Pierwszy sposób: + +wpisz w pasku adresowym "davs://<domain_name>/dav/<your_channelname>". + +Drugi sposób: + +1) Menu > Plik > Połącz z serwerem... +2) Wypełnij okna w formatce dialogowej: +- Sewer: hubzilla_domain_name +- Typ: Secure WebDAV (https) +- Folder: /dav +- Nazwa użytkownika: twoja_nazwa_kanału +- Hasło: twoje_hasło + +Po otwarciu możesz ustawić zakładkę. + +[h5][b]Uwagi dotyczące serwera[/b][/h5] + +Zgłoszono problemy z klientami używającymi "chunked transfer encoding", które obejmuje usługi Apple iOS, a także narzędzia "AnyClient" i "CyberDuck". Działają one dobrze w przypadku pobierania, ale przesyłanie często kończy się plikami o zerowym rozmiarze. Jest to spowodowane nieprawidłową implementacją kodowania fragmentarycznego w niektórych obecnych implementacjach FCGI (fast-cgi). Apache działający z PHP jako modułem nie ma tych problemów, ale podczas pracy pod FCGI może być konieczne użycie alternatywnych klientów lub użycie programu do przesyłania internetowego. W chwili pisania tego artykułu problem był otwarty i nie udostępniono żadnych aktualizacji przez co najmniej rok. Jeśli napotkasz pliki o rozmiarze zerowym z innymi klientami, zapoznaj się z uwagami klienta; ponieważ czasami występują problemy z konfiguracją, które również mogą powodować te objawy. + +[h3]Zapisane wyszukiwania[/h3] + +W celu szybkiego wyszukania informacji można skorzystać z widżetu "saved search". Ten widżet może być prezentowany jako narzędzie paska bocznego na Twojej stronie internetowej i prawdopodobnie na stronie Twojego kanału. Różni się od narzędzia wyszukiwania "paska nawigacji" tym, że nie przeszukuje całej witryny, a jedynie podzbiór informacji dostępnych na Twoim kanale. + +Ponadto podane przez Ciebie frazy wyszukiwania mogą aktywować jednorazowe wyszukiwanie lub zostać zapisane na liście do ponownego wykorzystania. Zapisanie elementu wyszukiwania wywołuje również przeszukiwanie, oprócz dodania go do zapisanej listy (która jest wyświetlana poniżej pola wprowadzania tekstu wyszukiwania). Każdy element na liście może zostać odrzucony, jeśli nie jest już potrzebny. + +Zapisany widżet wyszukiwania zapewni automatyczne uzupełnianie kanałów (wyniki są poprzedzone znakiem @) i hashtagami (poprzedzonymi znakiem #). Nie trzeba wprowadzać tych tagów; chociaż wprowadzenie żądanego tagu zmniejszy wyniki autouzupełniania, aby zawierały tylko istotne informacje. Zachowanie odwzorowuje się następująco: + +[list] +[*]@name - przeszukuje strumienia sieci w poszukiwaniu wpisów lub komentarzy napisanych przez 'name'. Spowoduje to również zmianę uprawnień edytora wpisów, aby zawierały tylko 'name'; jakby to była grupa prywatności. +[*]#hashtag - przeszukauje strumień sieci w poszukiwaniu wpisów zawierających #hashtag. +[*]text - przeszukaj strumień sieci w poszukiwaniu wpisów zawierających 'text'. +[/list] + + +[h3]Usunięcie kanału lub konta[/h3] + +[h4][b]Usuniecie kanału[/b][/h4] + +Wybierz link 'Usuń kanał' na stronie ustawień kanału lub odwiedź URL [baseurl]/removeme. + +Będziesz musiał potwierdzić swoje hasło i kanał, na którym jesteś obecnie zalogowany, zostanie usunięty. + +[hl][i][b]To jest nieodwracalne.[/b][/i][/hl] + +Jeśli masz klony tożsamości na innych portalach, nie zostaną one usuniete. Operacja ta spowoduje tylko usunięcie tej instancji kanału, która istnieje w portalu, na którym dokonujesz usunięcia kanału. + +[h4][b]Usuniecie konta[/b][/h4] + +Wybierz link 'Usuń konto' widoczny na stronie ustawień konta lub odwiedź URL: [baseurl]/removeaccount + +Będziesz musiał potwierdzić swoje hasło i konto, na którym jesteś obecnie zalogowany, zostanie usunięte. + +[hl][i][b]To jest nieodwracalne.[/b][/i][/hl] + +Wszystkie Twoje kanały zostaną usunięte. Jeśli masz klony tożsamości na innych portalach - nie zostaną one usuniete. Operacja ta powoduje tylko usunięcie instancji kanałów, które istnieją w portalu, na którym dokonujesz tą operację. + diff --git a/doc/pl/toc.html b/doc/pl/toc.html new file mode 100644 index 000000000..7c4806d9d --- /dev/null +++ b/doc/pl/toc.html @@ -0,0 +1,76 @@ +<div class="" id="accordion"> + <div class="panel"> + <div class=""> + <h3 class="panel-title"> + Poradniki + </h3> + </div> + <div id="tutorials" class="doco-section"> + <div class="flex-column"> + <a class="nav-link" href="/help/tutorials/personal_channel">Osobisty kanał</a> + </div> + </div> + </div> + <div class=""> + <div class="panel"> + <h3 class="panel-title"> + Dla użytkowników + </h3> + </div> + <div id="members" class="doco-section"> + <div class="flex-column"> + <a class="nav-link" href="/help/member/member_guide">Przewodnik</a> + <a class="nav-link" href="/help/feature/additional/overview">Dodatkowe możliwości</a> + <a class="nav-link" href="/help/member/bbcode">Informator o BBcode</a> + <a class="nav-link" href="/help/feature/additional/overview">Język opisu stron internetowych Comanche</a> + <a class="nav-link" href="/help/bugs">Zgłaszanie błędów</a> + <a class="nav-link" href="/help/member/member_faq">FAQ</a> + </div> + </div> + </div> + <div class="panel"> + <div class=""> + <h3 class="panel-title"> + Dla administratorów + </h3> + </div> + <div id="administrators" class="doco-section"> + <div class="flex-column"> + <a class="nav-link" href="/help/admin/administrator_guide">Przewodnik</a> + <a class="nav-link" href="/help/admin/hub_snapshots">Migawki portalu</a> + <a class="nav-link" href="/help/database">Baza danych</a> + <a class="nav-link" href="/help/hidden_configs">Dodatkowa konfiguracja</a> + </div> + </div> + </div> + <div class="panel"> + <div class=""> + <h3 class="panel-title"> + Dla deweloperów + </h3> + </div> + <div id="developers" class="doco-section"> + <div class="flex-column"> + <a class="nav-link" href="/help/developer/developer_guide">Przewodnik</a> + <a class="nav-link" href="/help/developer/covenant">Kodeks postępowania</a> + <a class="nav-link" href="/help/developer/zot_protocol">Protokół Zot</a> + <a class="nav-link" href="/help/developer/api_zot">API Zot</a> + <a class="nav-link" href="/help/hooklist">Zaczepy</a> + </div> + </div> + </div> + <div class="panel"> + <div class=""> + <h3 class="panel-title"> + Informacje o ... + </h3> + </div> + <div id="about" class="doco-section"> + <div class="flex-column"> + <a class="nav-link" href="/help/about/about">Platforma Hubzilla</a> + <a class="nav-link" href="/help/about/project">Projekt Hubzilla</a> + <a class="nav-link" href="/help/about/about_hub">Serwis HUBZILLA.PL</a> + </div> + </div> + </div> +</div> diff --git a/doc/pl/tutorials/assets/0965ace945f0c95ae38aa5bfedd230d2a7233d3915ac15d629f9dd845854.png b/doc/pl/tutorials/assets/0965ace945f0c95ae38aa5bfedd230d2a7233d3915ac15d629f9dd845854.png Binary files differnew file mode 100644 index 000000000..d5cf1093f --- /dev/null +++ b/doc/pl/tutorials/assets/0965ace945f0c95ae38aa5bfedd230d2a7233d3915ac15d629f9dd845854.png diff --git a/doc/pl/tutorials/assets/1ebe02c205962dd25035c441631745d16acdb7a44e50d148256c8ad26a67.png b/doc/pl/tutorials/assets/1ebe02c205962dd25035c441631745d16acdb7a44e50d148256c8ad26a67.png Binary files differnew file mode 100644 index 000000000..d613925aa --- /dev/null +++ b/doc/pl/tutorials/assets/1ebe02c205962dd25035c441631745d16acdb7a44e50d148256c8ad26a67.png diff --git a/doc/pl/tutorials/assets/2243e48ccea25bd907cce3dbd6fc9f7cd832a4c91a4c5dd294b7b219e7d8.png b/doc/pl/tutorials/assets/2243e48ccea25bd907cce3dbd6fc9f7cd832a4c91a4c5dd294b7b219e7d8.png Binary files differnew file mode 100644 index 000000000..c403bf806 --- /dev/null +++ b/doc/pl/tutorials/assets/2243e48ccea25bd907cce3dbd6fc9f7cd832a4c91a4c5dd294b7b219e7d8.png diff --git a/doc/pl/tutorials/assets/25eaad2435200f72a1dd3a00ba17a76ca6db4c246b3c4fa286b390cae7c8.png b/doc/pl/tutorials/assets/25eaad2435200f72a1dd3a00ba17a76ca6db4c246b3c4fa286b390cae7c8.png Binary files differnew file mode 100644 index 000000000..ca8ba6fb9 --- /dev/null +++ b/doc/pl/tutorials/assets/25eaad2435200f72a1dd3a00ba17a76ca6db4c246b3c4fa286b390cae7c8.png diff --git a/doc/pl/tutorials/assets/2b539d5a8474d6ec6dc91155b628d9be5f99ab04a78108ec404f53ec7bb5.png b/doc/pl/tutorials/assets/2b539d5a8474d6ec6dc91155b628d9be5f99ab04a78108ec404f53ec7bb5.png Binary files differnew file mode 100644 index 000000000..0da2d96e2 --- /dev/null +++ b/doc/pl/tutorials/assets/2b539d5a8474d6ec6dc91155b628d9be5f99ab04a78108ec404f53ec7bb5.png diff --git a/doc/pl/tutorials/assets/31f42a02bdbae095e0329db6c3814e2975979aff12f873f43d81724c5e61.png b/doc/pl/tutorials/assets/31f42a02bdbae095e0329db6c3814e2975979aff12f873f43d81724c5e61.png Binary files differnew file mode 100644 index 000000000..2a209b2be --- /dev/null +++ b/doc/pl/tutorials/assets/31f42a02bdbae095e0329db6c3814e2975979aff12f873f43d81724c5e61.png diff --git a/doc/pl/tutorials/assets/324247680b605fd214fd61aecd8f216fa8f5dfa0f16a04c8e968fdbc43d0.png b/doc/pl/tutorials/assets/324247680b605fd214fd61aecd8f216fa8f5dfa0f16a04c8e968fdbc43d0.png Binary files differnew file mode 100644 index 000000000..f992672b0 --- /dev/null +++ b/doc/pl/tutorials/assets/324247680b605fd214fd61aecd8f216fa8f5dfa0f16a04c8e968fdbc43d0.png diff --git a/doc/pl/tutorials/assets/3656a67dce40a1fc2515e9089217f2e136d4fcf8babe77bac00ecaad43ce.png b/doc/pl/tutorials/assets/3656a67dce40a1fc2515e9089217f2e136d4fcf8babe77bac00ecaad43ce.png Binary files differnew file mode 100644 index 000000000..b656192dc --- /dev/null +++ b/doc/pl/tutorials/assets/3656a67dce40a1fc2515e9089217f2e136d4fcf8babe77bac00ecaad43ce.png diff --git a/doc/pl/tutorials/assets/458a842c2ea0fbe3b7869bb14dfffe1e5be098d1cd6e590bbead25b4cc05.png b/doc/pl/tutorials/assets/458a842c2ea0fbe3b7869bb14dfffe1e5be098d1cd6e590bbead25b4cc05.png Binary files differnew file mode 100644 index 000000000..6129195b6 --- /dev/null +++ b/doc/pl/tutorials/assets/458a842c2ea0fbe3b7869bb14dfffe1e5be098d1cd6e590bbead25b4cc05.png diff --git a/doc/pl/tutorials/assets/4aaaf1e124514c8d6999a5fe1d07be5af460cda4ba6cde9106ebc1564bb0.png b/doc/pl/tutorials/assets/4aaaf1e124514c8d6999a5fe1d07be5af460cda4ba6cde9106ebc1564bb0.png Binary files differnew file mode 100644 index 000000000..923403fe9 --- /dev/null +++ b/doc/pl/tutorials/assets/4aaaf1e124514c8d6999a5fe1d07be5af460cda4ba6cde9106ebc1564bb0.png diff --git a/doc/pl/tutorials/assets/4cf326152797a8ecdf5630e921756f825ee00f8ee464d3ef9fed971d2852.png b/doc/pl/tutorials/assets/4cf326152797a8ecdf5630e921756f825ee00f8ee464d3ef9fed971d2852.png Binary files differnew file mode 100644 index 000000000..f158ad5d9 --- /dev/null +++ b/doc/pl/tutorials/assets/4cf326152797a8ecdf5630e921756f825ee00f8ee464d3ef9fed971d2852.png diff --git a/doc/pl/tutorials/assets/75d2927b7ad0d2043d4d3b6ba1364fac8ead173edd39340adaf78be11c9d.png b/doc/pl/tutorials/assets/75d2927b7ad0d2043d4d3b6ba1364fac8ead173edd39340adaf78be11c9d.png Binary files differnew file mode 100644 index 000000000..edc8b01cc --- /dev/null +++ b/doc/pl/tutorials/assets/75d2927b7ad0d2043d4d3b6ba1364fac8ead173edd39340adaf78be11c9d.png diff --git a/doc/pl/tutorials/assets/7c976a06662a1357b3da8ed0680d1a721c85f2ae2bdd5739a8def466010e.png b/doc/pl/tutorials/assets/7c976a06662a1357b3da8ed0680d1a721c85f2ae2bdd5739a8def466010e.png Binary files differnew file mode 100644 index 000000000..5b259058b --- /dev/null +++ b/doc/pl/tutorials/assets/7c976a06662a1357b3da8ed0680d1a721c85f2ae2bdd5739a8def466010e.png diff --git a/doc/pl/tutorials/assets/99a6efda4df631dfb2d2a849412044cc6a0f8aebeac289d28786f2649d24.png b/doc/pl/tutorials/assets/99a6efda4df631dfb2d2a849412044cc6a0f8aebeac289d28786f2649d24.png Binary files differnew file mode 100644 index 000000000..c03ffd18d --- /dev/null +++ b/doc/pl/tutorials/assets/99a6efda4df631dfb2d2a849412044cc6a0f8aebeac289d28786f2649d24.png diff --git a/doc/pl/tutorials/assets/9eae9fad774a4cd29e665961d35affbd053368056f562c58200fb41027b0.png b/doc/pl/tutorials/assets/9eae9fad774a4cd29e665961d35affbd053368056f562c58200fb41027b0.png Binary files differnew file mode 100644 index 000000000..65d4c5f0a --- /dev/null +++ b/doc/pl/tutorials/assets/9eae9fad774a4cd29e665961d35affbd053368056f562c58200fb41027b0.png diff --git a/doc/pl/tutorials/assets/b0bfdf02aef3710a37bb6092c3240b291eca8afa73133b3ac03b86f3302d.png b/doc/pl/tutorials/assets/b0bfdf02aef3710a37bb6092c3240b291eca8afa73133b3ac03b86f3302d.png Binary files differnew file mode 100644 index 000000000..45609a7bb --- /dev/null +++ b/doc/pl/tutorials/assets/b0bfdf02aef3710a37bb6092c3240b291eca8afa73133b3ac03b86f3302d.png diff --git a/doc/pl/tutorials/assets/b334915c03a665493915598c69c17a87c910a39db2cd3b5292e4623ea4c4.png b/doc/pl/tutorials/assets/b334915c03a665493915598c69c17a87c910a39db2cd3b5292e4623ea4c4.png Binary files differnew file mode 100644 index 000000000..d239d6965 --- /dev/null +++ b/doc/pl/tutorials/assets/b334915c03a665493915598c69c17a87c910a39db2cd3b5292e4623ea4c4.png diff --git a/doc/pl/tutorials/assets/b3eece28e8db67f1024af42055f0f24ed5e81ba622aca8cac576ccf5930e.png b/doc/pl/tutorials/assets/b3eece28e8db67f1024af42055f0f24ed5e81ba622aca8cac576ccf5930e.png Binary files differnew file mode 100644 index 000000000..45ed64d00 --- /dev/null +++ b/doc/pl/tutorials/assets/b3eece28e8db67f1024af42055f0f24ed5e81ba622aca8cac576ccf5930e.png diff --git a/doc/pl/tutorials/assets/bdbcf0ffd9004657237f6b7b7863da5a8e39a5bc17d2c67fa160efef2056.png b/doc/pl/tutorials/assets/bdbcf0ffd9004657237f6b7b7863da5a8e39a5bc17d2c67fa160efef2056.png Binary files differnew file mode 100644 index 000000000..fcaed8bef --- /dev/null +++ b/doc/pl/tutorials/assets/bdbcf0ffd9004657237f6b7b7863da5a8e39a5bc17d2c67fa160efef2056.png diff --git a/doc/pl/tutorials/assets/c4cad3e4c356dd2a227df79bd4dc6d47edf1b66ea243f005b6b452ec366b.png b/doc/pl/tutorials/assets/c4cad3e4c356dd2a227df79bd4dc6d47edf1b66ea243f005b6b452ec366b.png Binary files differnew file mode 100644 index 000000000..0ccfc8995 --- /dev/null +++ b/doc/pl/tutorials/assets/c4cad3e4c356dd2a227df79bd4dc6d47edf1b66ea243f005b6b452ec366b.png diff --git a/doc/pl/tutorials/assets/c9a880cc82ffa1f7c2f460397bb083bf7dc2a2b8f065e64da598b45b4a2b.png b/doc/pl/tutorials/assets/c9a880cc82ffa1f7c2f460397bb083bf7dc2a2b8f065e64da598b45b4a2b.png Binary files differnew file mode 100644 index 000000000..1cb4d2d22 --- /dev/null +++ b/doc/pl/tutorials/assets/c9a880cc82ffa1f7c2f460397bb083bf7dc2a2b8f065e64da598b45b4a2b.png diff --git a/doc/pl/tutorials/assets/d080e92d797af5e863fa39b2084c16a8410de1f7a6559633435817444aef.png b/doc/pl/tutorials/assets/d080e92d797af5e863fa39b2084c16a8410de1f7a6559633435817444aef.png Binary files differnew file mode 100644 index 000000000..22e4cb5d5 --- /dev/null +++ b/doc/pl/tutorials/assets/d080e92d797af5e863fa39b2084c16a8410de1f7a6559633435817444aef.png diff --git a/doc/pl/tutorials/assets/e05248fdc5688d6d24bde52432fdc7b39692a094559aa504de99352940b1.png b/doc/pl/tutorials/assets/e05248fdc5688d6d24bde52432fdc7b39692a094559aa504de99352940b1.png Binary files differnew file mode 100644 index 000000000..5674f5207 --- /dev/null +++ b/doc/pl/tutorials/assets/e05248fdc5688d6d24bde52432fdc7b39692a094559aa504de99352940b1.png diff --git a/doc/pl/tutorials/assets/e5d5674a34e848e2cce90a60fc416415271d9c51b81ad2a950fb0157222a.png b/doc/pl/tutorials/assets/e5d5674a34e848e2cce90a60fc416415271d9c51b81ad2a950fb0157222a.png Binary files differnew file mode 100644 index 000000000..e6b4a9974 --- /dev/null +++ b/doc/pl/tutorials/assets/e5d5674a34e848e2cce90a60fc416415271d9c51b81ad2a950fb0157222a.png diff --git a/doc/pl/tutorials/assets/ef78bc6aa3fafebd46f353514c907b3fdfe019918fc5553bb3f31388a36f.png b/doc/pl/tutorials/assets/ef78bc6aa3fafebd46f353514c907b3fdfe019918fc5553bb3f31388a36f.png Binary files differnew file mode 100644 index 000000000..8de042ae4 --- /dev/null +++ b/doc/pl/tutorials/assets/ef78bc6aa3fafebd46f353514c907b3fdfe019918fc5553bb3f31388a36f.png diff --git a/doc/pl/tutorials/assets/facb0bdfdecb4c779de9048cd14b417c0d76de17af476be5f296b78d70e9.png b/doc/pl/tutorials/assets/facb0bdfdecb4c779de9048cd14b417c0d76de17af476be5f296b78d70e9.png Binary files differnew file mode 100644 index 000000000..cec391fb4 --- /dev/null +++ b/doc/pl/tutorials/assets/facb0bdfdecb4c779de9048cd14b417c0d76de17af476be5f296b78d70e9.png diff --git a/doc/pl/tutorials/personal_channel.md b/doc/pl/tutorials/personal_channel.md new file mode 100644 index 000000000..39029110e --- /dev/null +++ b/doc/pl/tutorials/personal_channel.md @@ -0,0 +1,116 @@ + +Ten poradnik trzeba wykonać w kolejności, tak jakbyś konfigurował plik kanału po raz pierwszy. Przedstawia w naturalny sposób niektóre narzędzia i funkcje związane z kanałem osobistym. + +### Tworzenie nowego kanału + +Kiedy logujesz się po raz pierwszy po rejestracji, musisz utworzyć kanał albo odwiedzić później stronę *https://your_website/new_channel*. + + + +Wprowadź swoje imię i nazwisko oraz pseudonim dla adresu kanału, a następnie wybierz "rolę". Zazwyczaj, jeśli reprezentuje Cię osobisty kanał, wybierz *Społecznościowy* z domyślnym poziomem prywatności, który Ci odpowiada. Jeśli nie masz pewności, wybierz opcję *Społecznościowy - głównie publiczne*, co umożliwia łatwą interakcję i zapewnia prywatność, gdy jej potrzebujesz. Alternatywnie, ustawienie *Społecznościowy - ograniczony* jest bardzo popularne wśród obrońców prywatności, chociaż poznanie ludzi może wymagać nieco więcej wysiłku. Niezależnie od tego, które ustawienie wybierzesz, możesz zmienić je później, jeśli zajdzie taka potrzeba. + +### Dodanie zdjęcia profilowego + +Po utworzeniu nowego kanału zostaniesz przekierowany na stronę określoną przez administratora witryny. Domyślnie jest to strona *Edytuj profil*. + +Z poziomu rozwijanego menu *Narzędzia profili* wybierz opcję *Zmień zdjęcie profilowe* (lub po prostu kliknij zdjęcie profilowe). + + + +Prześlij swoje zdjęcie i jeśli to konieczne, zmień rozmiar za pomocą edytora obrazów. + + + +Po naciśnięciu *Edycja zakończona* nastąpi przekierowanie z powrotem do edytora profili. + +> Jeśli masz problemy z wyświetleniem nowego zdjęcia, może być konieczne +> wyczyszczenie pamięci podręcznej przeglądarki. + + + +Po powrocie na stronę główną kanału zobaczysz, że wpis został automatycznie opublikowany wpis powiadamiający innych o Twoim nowym zdjęciu profilowym. + + + + +### Tworzenie wpisów + +Przejdź do strony głównej swojego kanału i otwórz edytor wpisów, naciskając pole tekstowe *Udostępnij* u góry "ściany" kanału. Wprowadź wiadomość, a następnie przeciągnij i upuść plik obrazu do do obszaru tekstowego edytora wpisów. Ewentualnie możesz użyć narzędzie *Załącz plik*, widoczne u dołu. + + + +Plik obrazu zostanie automatycznie przesłany i zapisany w plikach w chmurze, a łącze pojawi się w oknie wpisu. Naciśnięcie przycisku podglądu wpisu umożliwia podgląd wpisu przed opublikowaniem. + + + +Naciśnij przycisk kłódki obok przycisku *Prześlij*. SPowoduje to otworzenie się *Listę kontroli dostępu*, gdzie możesz dokładnie określić, kto ma dostęp do tego wpisu. + + + + +### Użycie przesłanego obrazu jako zdjęcia na okładkę kanału + +Jednym ze sposobów uatrakcyjnienia wyglądu kanału jest dodanie zdjęcia na okładkę, które będą widzieć użytkownicy po załadowaniu strony kanału. Zintegrowany system plików w chmurze pozwala wybrać w tym celu istniejące zdjęcie. + +Odwiedź swoje zdjęcia w aplikacji *Photos*. + + + +Wybierz zdjęcie, którego chcesz użyć i wybierz *Użyj jako zdjęcia na okładkę* z rozwijanego menu *Narzędzia do zdjęć*. + + + +Przytnij obraz za pomocą edytora zdjęć i zapisz zmiany. + + + +Gdy załadujesz stronę główną swojego kanału, najpierw zobaczysz zdjęcie okładkowe a strona kanału będzie się pojawiać w miarę przewijania w dół. + + + + +### Wykonywanie połączeń + +Tworzenie połączeń między kanałami i udostępnianie treści, to istosta komunikacji społecznej. Nawiązanie połączenia jest proste. Jeśli jeszcze nie wiesz, jak dotrzeć do strony domowej kanału, możesz spróbować przeszukać katalog, otwierając łącze *Katalog* z menu po prawej stronie z boku górnego paska nawigacyjnego. + + + +Możesz połączyć się bezpośrednio z poziomu katalogu za pomocą przycisku *Połącz* lub możesz najpierw otworzyć stronę kanału i nacisnąć przycisk *Połącz* widoczny poniżej zdjęcia profilowego. + + + +Po nawiązaniu połączenia zostaniesz natychmiast przeniesiony do strony edytora połączeń, gdzie podejmujesz ważne decyzje dotyczące tego, co planujesz udostępniać na tym kanale. + + + +Dwa ważne ustawienia to + +* Indywidualne uprawnienia dla nowo podłączonego kanału +* Grupy prywatności, do których należy połączenie + +Indywidualne uprawnienia są w większości łatwe do zrozumienia, ale mogą być na początku niejasne. Na przykład *Można wyświetlać mój magazyn plików i zdjęć* nie oznacza, że na podłączonym kanale każdy będzie mógł przeglądać wszystkie Twoje zdjęcia i pliki! Oznacza to, że będziesz mieć możliwość udostępniania zdjęć i plików za pomocą tego kanału. Jest całkiem możliwe, że pozwolisz komuś czytać swoje wpisy, ale nie zezwolisz na oglądanie zdjęć w tym wpisie. + +Grupy prywatności umożliwiają wygodnie udostępniać elementy grupom osób. Można utworzyć dowolne grupy odpowiadające swoim potrzebom, otwierając link *Dodaj grupę prywatności*. + + + +W tym edytorze można przełączać się między istniejącymi grupami prywatności i od razu sprawdzić, jakie kanały są, a jakie nie są członkami grupy. Wybranie ikony kanału w dowolnym polu spowoduje przeniesienie kanału do tej grupy. + + + +Podczas edycji ustawień pojedynczego kanału można ustawić jego członkostwo w grupach prywatności za pomocą widżetu po lewej stronie: + + + +Połączenia to wzajemne zaangażowanie. Kanał, z którym się łączysz, może mieć ustawioną opcję zatwierdzenia połączenia z innym kanałem. Zostanie wówczas wysłane do niego powiadomienie o proonowanym połączeniu: + + + +w którym znajduje się link do strony edytora [*Połączenia*](https://grid.reticu.li/connections), gdzie można zdecydować, czy zezwolić na połączenie, czy nie. + + + +Po zatwierdzeniu połączenia dobrze jest otworzyć edytor połączeń indywidualnych, naciskając przycisk edycji obok przycisku *Usuń*. + + + |
