Jak zrobić swój własny cookbook Opcje

[athabus]

Witam,

pewnie wielu z Was napotyka taki problem, że robicie co jakiś czas pewną rzecz, która jest nie do końca "oczywista". Tracicie godzinę na wymyślnie rozwiązania, mijają dwa miesiące czasu, trafiacie na taki sam problem i zaczyna się "już to robiłem, gdzie to było... to chyba w tym projekcie" itd.

Ja ostatnio mam tak z kilkoma rzeczami w symfony - głównie z dostosowywaniem formularzy/panelu admina.

I tak sobie postanowiłem, że nastał czas na stworzenie własnego cookbook'a, czyli zbioru problemów, które już rozwiązałem i chciałbym móc łatwo do nich wracać. Chciałbym aby było to miejsce gdzie mógłbym zostawić trochę kodu + jakiś opis. Na początku pomyślałem o wiiki, ale średni tam się operuje kodem - może jest coś lepszego do tego? Jeśli nie to jaki skrypt wikii byście polecili?

Myślałem też nad zbiorem plików na droopbox ale, to jednak przy większej ilości będzie trudne do ogarnięcia, bo przydałby się spis treści z krótkim opisem danej wskazówki.

[destroyerr]

Ostatnio zacząłem korzystać ze sphinxa i jest całkiem przyjemnie. Możesz wygenerować wiele różnych formatów (html, pdf, epub...). Podoba mi się to, że dużo roboty już na początku jest zrobione: przyjemny system linkowania, wstawianie kodu php, dużo możliwości edytorskich. Wtedy możesz łatwo pchnąć to do tego dropboxa.
Możesz też poszukać innych generatorów statycznych stron (w pythonie i rubym jest tego sporo), główna różnica to będzie format wprowadzanego tekstu.

Rozwiązania oparte o pliki (nie o bazę danych) dają większą przenośność i możesz mieć od razu kontrolę wersji (git).