aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorMario <mario@mariovavti.com>2021-06-05 07:52:43 +0000
committerMario <mario@mariovavti.com>2021-06-05 07:52:43 +0000
commit0784d2ea4e4f492d9f03d025b56d603d15b5ee89 (patch)
treee7ccf216da5cac2f3bef12cb80e5f61fe6fe356c /doc
parent7b3eb09067e08bc017b71f5f05aef5a67eb5b05a (diff)
parentb90db6931de2e1989cf44fac9ef037d1bc2cc16b (diff)
downloadvolse-hubzilla-0784d2ea4e4f492d9f03d025b56d603d15b5ee89.tar.gz
volse-hubzilla-0784d2ea4e4f492d9f03d025b56d603d15b5ee89.tar.bz2
volse-hubzilla-0784d2ea4e4f492d9f03d025b56d603d15b5ee89.zip
Merge branch 'dev' into six
Diffstat (limited to 'doc')
-rw-r--r--doc/context/pl/register/help.html54
-rw-r--r--doc/pl/about/about.bb2
-rw-r--r--doc/pl/comanche.md272
-rw-r--r--doc/pl/toc.html3
4 files changed, 329 insertions, 2 deletions
diff --git a/doc/context/pl/register/help.html b/doc/context/pl/register/help.html
new file mode 100644
index 000000000..c5c879e36
--- /dev/null
+++ b/doc/context/pl/register/help.html
@@ -0,0 +1,54 @@
+<dl class="dl-horizontal">
+ <dt>Ogólne</dt>
+ <dd>
+ Na tej stronie odwiedzający mogą zarejestrować się, aby uzyskać dostęp do
+ portalu za pomocą identyfikatora logowania. Zalogowani użytkownicy nie tylko
+ widzą treści publiczne, ale mogą je sami publikować, komunikować się w sieciach
+ społecznościowych i nie tylko.
+ </dd>
+ <dt>Tryby rejestracji</dt>
+ <dd>
+ Rejestracja jest możliwa na adres e-mail lub anonimowo, jeśli regulamin portalu
+ to dopuszcza (wówczas nie wypełniaj pola e-mail). Możliwe, że masz również
+ kod zaproszenia, który trzeba wprowadzić wraz z adresem e-mail. Link nad polem
+ e-mail umożliwia wprowadzenie kodu zaproszenia. Ustaw też swoje hasło logowania.
+ Musisz podać go dwukrotnie. Nie jest ono jawnie wyświetlane w formularzu, więc
+ uważaj przy jego wprowadzaniu.
+ </dd>
+ <dt>Procedura rejestracji</dt>
+ <dd>
+ Aby zalogować się po udanej rejestracji, należy ustawić osobne hasło.
+ Ze względów bezpieczeństwa wprowadź je dwukrotnie z identycznymi wartościami.
+ Zarejestrowani anonimowo użytkownicy otrzymują automatycznie przypisywany identyfikator
+ i nie powinni zapomnieć własnego hasła, ponieważ w przeciwieństwie do rejestracji
+ adresem e-mail początkowo nie ma funkcji resetowania. W zależności od konfiguracji
+ portalu może być wymagana funkcja potwierdzenia. Użytkownicy rejestracji
+ przy użyciu adresu e-mail otrzymają odpowiednią wiadomość. W przypadku rejestracji
+ anonimowych zostanie wyświetlone inne okno dialogowe zawierające identyfikator
+ dostępu i kod PIN. Dane z tej strony powinny być przechowywana bezpiecznie i przez
+ długi czas (np. przez wydruk, zrzut ekranu, zdjęcie), ponieważ dane muszą zostać
+ ponownie potwierdzone w późniejszym czasie.
+ </dd>
+ <dt>Tożsamość cyfrowa</dt>
+ <dd>
+ W zależności od portalu, wyświetlaną nazwę (imię i nazwisko) oraz pseudonim można
+ wprowadzić już podczas rejestracji (alternatywnie również podczas pierwszego logowania).
+ Pseudonim ma bardzo ważne znaczenie i nie można go później zmienić. Jest to unikalna
+ tożsamość cyfrowa (Digital Identity, DID), która jest, będzie i pozostanie powiązana
+ ze wszystkimi naszymi działaniami. Ten DID nadaje się nie tylko do logowania na
+ tym portalu, ale także do wszystkich połączonych portali sieci federacyjnej.
+ W języku sieci federacyjnych ta tożsamość cyfrowa jest "kanałem".
+ Jest to porównywalne z numerem telefonu w sieci telefonicznej. DID ma format
+ kanał@portal.tld = pseudonim@portal.tld i jak wspomniano, nie można go później
+ zmienić. Chociaż format wygląda jak adres e-mail, tak nie jest.
+ </dd>
+ <dt>Nim rozpoczniesz rejestrację ...</dt>
+ <dd>
+ ... należy wybrać preferowany język (na przykład polski, angielski, hiszpański,
+ niemiecki) (w prawym górnym rogu menu hamburgera <span class = "fa fa-fw fa-bars"> </span>).
+ Aktualny język jest używany w kolejnych krokach, a także podczas logowania i po
+ zalogowaniu. Można to jednak zmienić w dowolnym momencie i w razie potrzeby.
+ Należy również zauważyć, że ten portal nie jest jedyny. Przegląd innych portali
+ można znaleźć <a href="./pubsites"> tutaj </a>.
+ </dd>
+</dl>
diff --git a/doc/pl/about/about.bb b/doc/pl/about/about.bb
index 1700d3250..0a5c3620a 100644
--- a/doc/pl/about/about.bb
+++ b/doc/pl/about/about.bb
@@ -174,7 +174,7 @@ 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]Rozszerzaie $Projectname[/h4]
+[h4]Rozszerzanie $Projectname[/h4]
$Projectname może zostać rozszerzona na wiele sposobów, poprzez dostosowanie witryny, personalizację, ustawienia opcji, motywy i dodatki - wtyczki.
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/toc.html b/doc/pl/toc.html
index f478fcf15..157a50eaa 100644
--- a/doc/pl/toc.html
+++ b/doc/pl/toc.html
@@ -20,8 +20,9 @@
<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/member/bbcode">Informator o BBcode</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>