diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/context/pl/register/help.html | 54 | ||||
| -rw-r--r-- | doc/pl/about/about.bb | 2 | ||||
| -rw-r--r-- | doc/pl/comanche.md | 272 | ||||
| -rw-r--r-- | doc/pl/toc.html | 3 |
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> |