O serwisie

PLD nigdy nie kryło, że powstało głównie z myślą o swoich twórcach. Jednak w rzeczywistości dystrybucja to nie tylko programy do zainstalowania. To także społeczność – pisząca dokumentację, pomagająca z problemami technicznymi, tworząca unikalną oprawę graficzną. Ta strona powstała z myślą o ludziach, którzy chcieliby jakoś wspomóc rozwój projektu.

Jak pomóc?

Dodając treść oczywiście. Po pierwsze upewniając się, czy nie zapomnieliśmy o czymś napisać, gdzieś podlinkować, czegoś wytłumaczyć, a po drugie – pisząc przewodniki. I nie należy się specjalnie martwić ich jakością – to nie jest oficjalna dokumentacja PLD, nikt tu nie będzie na nikogo krzyczał za złą stylistykę. Minimalnie przeredagowana rozmowa z IRC-a, czy wątek z forum też mogą być przydatne, a niewykluczone, że ktoś to później poprawi i jakoś ładniej zredaguje. Treść ważniejsza od formy!

Zasady edycji

  • Serwis pld-users.org używa systemu wiki (konkretnie dokuwiki), więc wystarczy się zarejestrować i do roboty!
  • Wszystkie wersje językowe są niezależne od siebie. Jeśli ktoś chce coś przetłumaczyć, droga wolna, ale nie ma takiego obowiązku.
  • Jeśli w pasku adresu przeglądarki widać pl/jakas-strona, to tytułem strony będzie jakas strona - pld-users.org. Dlatego też zaleca się naprawdę dobrze zastanowić przy wymyślaniu nazw podstron. Po pierwsze ze względu na ogólny wygląd serwisu, po drugie ze względu na czytelność URL-i (by było łatwo stwierdzić co można znaleźć pod danym adresem) oraz po trzecie – patrz punkt następny.
  • W przypadku odnośników do stron wewnętrznych (tzn. znajdujących się na tym serwisie) warto pamiętać, że wiki automatycznie „normalizuje” podane nazwy. Tzn. link w postaci [[O serwisie]] wyświetli się z tekstem O serwisie, natomiast odnośnik będzie wskazywał na adres pl/o-serwisie. Oznacza to, że jeśli podstrony są sensownie nazwane, to łatwiej się do nich linkuje (oraz że przy tworzeniu odnośników nie należy dodawać na początku pl/, gdyż zostanie to zrobione automatycznie).
  • Wszystkie przewodniki należy umieszczać w przestrzeni nazw pl/przewodniki (np. pl/przewodniki/jak-skasowac-windowsa), po czym umieszczać do nich odnośnik w spisie przewodników.
  • Wpisywane przykłady poleceń obejmujemy tagami <code></code>
poldek --help
Usage: poldek [OPTION...] [PAKIET...]
poldek 0.30 (snap20080820.23)  
  • Wpisywane nazwy plików konfiguracyjnych pogrubiamy **/etc/fstab** ⇒ /etc/fstab
  • Fragmenty plików konfiguracyjnych obejmujemy tagami <file></file>

etc/resolv.conf

#search home.aster.pl
nameserver 212.76.33.102

Problemy i Pytania

Masz jakiś problem związany z pld-users.org? Zapytaj na kanale #pldhelp w sieci FreeNode, lub na jabberze/xmpp:

  • grizz pld-users.org
pl/o-serwisie.txt · ostatnio zmienione: 2008/10/24 14:57 przez grizz
chimeric.de = chi`s home Creative Commons License Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0 Powered by Lighttpd - fly light