Pytanie 20
Jakie są podstawowe zasady edytowania stron na CiupakKommanderze?
Na początek wypada wspomnieć o trzech bardzo ważnych sprawach.
Po pierwsze, nie należy tworzyć zbędnych bytów, nie wolno śmiecić na CiupakKommanderze tworząc nie przydatne dziwolągi, strony testowe, aby "sobie spróbować". W celach testów, eksperymentów, uczenia się CiupakKommandera, należy korzystać z Piaskownicy.
Po drugie, przy tworzeniu strony można używać znaczników HTML, ale nie jest to wygodne i nie jest zalecane. Towarzysz Ciupak zaimplementował też podstawowe mechanizmy Markdown, dzięki czemu formatowanie stron jest niezwykle proste, szybkie i efektywne dla każdego, także i dla tych, co nie mają bladego pojęcia o HTML. Ten sposób - znaczniki markdown - jest zalecany.
Po trzecie, ponieważ każdy obywatel może tworzyć i edytować w banalny sposób strony na CiupakKommanderze, to każdy obywatel może i powinien poprawiać błędy znalezione na tych stronach, jak również powinien wnieść swoją cegiełkę i rozwijać zalążki już istniejących stron. W razie wątpliwości zawsze można zapytać na grupie dyskusyjnej, co i jak, oraz czy autor danej strony nie ma nic przeciw. Tak grzecznościowo.
Więcej informacji
Markdown do niezwykle prosty i wygodny język znaczników, jaki służyć może do edytowania prostych stron WWW. Najwięcej informacji na ten temat, wraz z odnośnikami do innych źródeł informacji, znaleźć można w anglojęzycznej wikipedii - tutaj. W języku polskim najważniejsze zasady zebrano m.in. na tej stronie. Towarzysz Ciupak również utworzył nieco plików pomocy, choć z pewnością nie wyczerpują tematu, mogą być jednak przydatne.
No dobrze, teraz kilka praktycznych wskazówek:
Jeżeli chcesz zastosować pogrubienie tekstu, obejmij taki tekst podwójnymi gwiazdkami:
**ten tekst będzie pogrubiony**
ten tekst będzie pogrubiony
Jeżeli chcesz, aby tekst wyświetlany był czcionką pochyloną, obejmij taki tekst pojedynczymi gwiazdkami:
*ten tekst będzie pochylony*
ten tekst będzie pochylony
Jeżeli chcesz utworzyć odnośnik do jakiejś strony WWW nie będącej stroną systemu CiupakKommandera, albo do jakiegoś pliku, użyj nawiasu kwadratowego i okrągłego, wg. poniższego schematu:
[tutaj napisz treść odnośnika](tutaj podaj URL)
[link do gógla](http://www.google.pl/)
link do gógla
Jeżeli chcesz zamieścić na stronie obrazek, postępuj podobnie jak w przypadku tworzenia linku, ale na początku postaw wykrzyknik:
Jeżeli chcesz zamieścić link do jakiejś strony znajdującej się w systemie CiupakKommandera, podaj tylko samą nazwę tej strony, jaka występuje w adresie URL, i obejmij ją podwójnymi nawiasami kwadratowymi:
URL: http://www.wandystan.only.pl/w/Promocja
Promocja
Jeżeli chcesz zamieścić link do jakiejś strony znajdującej się w systemie CiupakKommandera, ale zarazem chcesz, aby tekst wyświetlający się na stronie jako link nie był treścią linka, to zrób tak: napisz w obrębie podwójnych nawiasów kwadratowych nazwę z adresu URL strony, do jakiej linkujesz, postaw następnie - bez spacji - kreskę "|", i po niej napisz - bez spacji - treść linka:
Adresy URL systemów stron na CiupakKommanderze w zakresie swoich nazw są dwuczłonowe. Zawsze występuje, jako pierwszy człon nazwy, stały identyfikator danego systemu stron. Po nim ma miejsce podwójny dwukropek "::" i występuje drugi człon - nazwa właściwa konkretnej strony.
Jeżeli chcesz utworzyć odnośnik w obrębie danego systemu stron do jakiejś innej jego strony składowej, w nazwie z URL tej strony, jaką wpisujesz do podwójnych nawiasów kwadratowych, zrezygnuj z pierwszego członu. Inaczej mówiąc - użyj tylko członu stanowiącego nazwę właściwą, z zachowaniem podwójnego dwukropka na początku.
Przykład - niniejszy dział "Informacji" posiada następujące nazwy URL: "FAQ::Strona_główna", "FAQ::Geneza", "FAQ::Skąd_nazwa_Wandystan" itp. Jeżeli na jakiejś stronie tego systemu, a więc na stronie składowej działu "Informacje" pragniemy podlinkować do innej jego strony, powiedzmy do "FAQ::Skąd_nazwa_Wandystan" (pełny URL to http://www.wandystan.only.pl/w/FAQ::Skąd_nazwa_Wandystan), utworzymy ten link następująco:
Jeżeli chcesz utworzyć odnośnik do strony z profilem, postępuj dokładnie tak samo jak w powyższych przykładach z linkami do stron na CiupakKommanderze, przy czym zamiast nazwy strony z adresu URL użyj czegoś takiego:
a!profil,BXXXX
Oto konkretny przykład:
Jeżeli klikniesz na "Nowa strona", wypełnisz pola tekstowe i w ten sposób utworzysz nową stronę, będzie ona prawidłowa, przy czym jej stylistyka będzie taka, jak stylistyka strony głównej. Przykładem może być strona Promocja.
Jeżeli zechcesz utworzyć nowy system stron, to w takim celu nie tylko potrzebujesz stworzyć odpowiednie strony składowe, lecz także dodatkowe strony specjalne. Tak więc pragnąć utworzyć system o nazwie "Kogut", potrzeba jeszcze stronę "Kogut::style" - definiującej, jak mają wyglądać strony o nazwie "Kogut", a więc, jaką mają mieć stylistykę, oraz stronę "Kogut::menu" - definiującą, jak ma wyglądać menu systemu stron wyświetlane w prawej kolumnie nawigacyjnej. Oczywiście, to, co zostaje zdefiniowane w plikach "style" i "menu" dotyczy już każdej strony składowej danego systemu.
Chcąc utworzyć nowy system stron należy rozpocząć od wyboru opcji "Różne" - i tam utworzyć nową przestrzeń nazw. Formularz tworzenia nowej przestrzeni nazw pozwala nadać tworzonemu systemowi pierwszy, stały człon nazwy w URL, a także niezależną od adresu URL nazwę całego systemu, wyświetlaną na górnym pasku przeglądarki przy każdej stronie składowej. Wypełnienie formularza zarazem automatycznie wygeneruje prosty szablon składający się z bazowej strony głównej, oraz stron "style" i "menu". Stylistyka tego szablonu jest klasyczna. Dalsze tworzenie systemu stron jest już ułatwione po przez to, że zalążki stron już istnieją - po prostu się je edytuje.
Warto jeszcze wspomnieć, że jeżeli wszystkie te strony utworzy się ręcznie, zaś w następnej kolejności będzie się dla nich chciało utworzyć przestrzeń nazw (bo bez tworzenia przestrzeni nazw żadna ze stron składowych systemu nie będzie mieć tego samego tytułu wyświetlanego w przeglądarce), to skrypt i tak wygeneruje szablon nadpisując "Stronę_główną", "style" oraz "menu". To może być bolesne doświadczenie :-D