Pomoc:Mechanizm działania eksportera
Tworzenie e-booka dla potrzeb czytelnika podlega na Wikiźródłach licznym ograniczeniom.
W tym tekście skupiam się na technicznych ograniczeniach, na tworzeniu struktury, tak by na końcu uzyskać funkcjonalny plik generowany przez eksportera.
Eksperymenty z generowaniem e-booków bywają nieco frustrujące:
- nie zawsze e-book jest generowany z najnowszej wersji tekstu
- generowanie e-booka trwa dość długo
Na końcu można znaleźć kilka słów na ten temat.
Rozdziały
[edytuj]W e-booku może być spis treści i rozdziały. Ściśle rzecz biorąc pewna rudymentarna struktura powstaje zawsze, niemniej jednak nie to mam na myśli.
Rozdziały w e-booku pozwalają na nawigację przy pomocy strzałek (czy innych skrótów) od jednego do następnego (lub poprzedniego) rozdziału, generują też spis treści TOC.
Nasz generator e-booków umożliwia tworzenie dwóch poziomów rozdział-podrozdział (nazwa nie ma znaczenia, może to być część-rozdział, tom-księga, akt-scena itp.)
Jeśli mamy więc dwa poziomy uzyskujemy dodatkowo rozwijalny spis treści, co czyni spis treści nieco bardziej przejrzystym.
Tworzenie rozdziałów
[edytuj]Tworzymy najpierw pewną stronę wyjściową (główną, indeksującą). Na niej są odnośniki do innych stron. Będą to rozdziały naszego e-booka, a linkowane strony zostaną włączone do e-booka. Jeśli na tych stronach dalej są odnośniki do innych strony, i te strony mogą zostać włączone jako podrozdziały.
Sposób prezentacji rozdziałów i podrozdziałów zależy od linków, przy czym zachowywany jest sposób prezentacji linku [[ linkowana strona | widoczna jako ]].
A co z summary?
[edytuj]Cóż, to jest aspekt techniczny przy tworzeniu struktury e-booków.
Kiedy jest potrzebne summary[1]?
- gdy na stronie indeksującej (głównej, wyjściowej) linki, które chcemy włączyć, nie są jej podstronami.
- na stronie głównej (wyjściowej) gdy chcemy ewentualnie zrobić jakąś bardziej skomplikowaną strukturę (np. strony, które mają być włączone jako rozdziały występują obok linków do stron, które nie mają być włączone) – chodzi o to, że korzystając z {{summary| oraz {{summary|widoczny=nie| można pokryć różne skomplikowane sytuacje. Można też użyć <div class="ws-noexport">
- "piętro niżej", tj. na już włączonej stronie
Jak jest tworzona struktura e-booka?
[edytuj]E-book ze spisem treści rozwijalnym:
Zwinięty spis treści | Rozwinięty spis treści | Rozwinięty spis treści |
Wstęp ►Rozdział pierwszy ►Rozdział drugi ►Rozdział trzeci |
Wstęp ▼Rozdział pierwszy Podrozdział I Podrozdział II Podrozdział III Podrozdział IV Podrozdział V ►Rozdział drugi ►Rozdział trzeci |
Wstęp ►Rozdział pierwszy ▼Rozdział drugi Podrozdział I Podrozdział II Podrozdział III Podrozdział IV Podrozdział V Podrozdział VI Podrozdział VII Podrozdział VIII Podrozdział IX ►Rozdział trzeci |
E-book ze spisem treści nierozwijalnym:
Wstęp
Rozdział pierwszy
Podrozdział I
Podrozdział II
Podrozdział III
Podrozdział IV
Podrozdział V
Rozdział drugi
Podrozdział I
Podrozdział II
Podrozdział III
Podrozdział IV
Podrozdział V
Podrozdział VI
Podrozdział VII
Podrozdział VIII
Podrozdział IX
Rozdział trzeci
Podrozdział I
Podrozdział II
Podrozdział III
Jak widać, pierwsza wersja wygląda nieco bardziej przejrzyście, ale
- nie w każdej przeglądarce ta struktura jest widoczna
- przy czytaniu tekstu ciągłego (powieści) niewiele zasadniczo rzecz biorąc daje (i tak czytamy po kolei tekst)
- korzystając ze spisu treści utworzonego na stronach e-booka nawigujemy niejako obok tego spisu treści
i co najważniejsze
- przy pomocy ws-exportera możemy zrobić jedynie dwa poziomy (a więc rozdział/podrozdział jak powyżej, przy czym konkretne nazwy część, księga, rozdział, pieśń, akt itp. nie mają znaczenia technicznego)
Jeszcze o summary
[edytuj]W typowym przypadku (tzn. jeśli chcemy wszystkie linkowane strony włączyć do e-booka) na stronie głównej szablon summary jest niepotrzebny, gdy odnośniki prowadzą do podstron danej strony (czyli po nazwa strony głównej/dalszy ciąg nazwy)[2]. Jest konieczny jednak gdy linkowane strony, które mają być włączone nazywają się inaczej (czyli nie są podstronami strony głównej).
Na drugim poziomie (a więc w rozdziałach), gdy chcemy włączyć podrozdziały summary jest konieczne.
O kolejności włączenia decyduje kolejność wystąpienia na stronie.
by-pass cache
[edytuj]lub odpowiednia opcja na stronie:
Nawet to może się okazać niewystarczające, warto zrobić na stronie w przestrzeni głównej purge lub jakąś drobną edycję.
Typy tekstów na Wikiźródłach
[edytuj]Przedstawiono wcześniej klasyfikację tekstów na Wikiźródłach. Podział ten jest jednak do pewnego stopnia akademicki. Istotne jest, by pamiętać o pewnych zasadach i ograniczeniach, wtedy klasyfikacja staje się sprawą wtórną.
- Nie należy niepotrzebnie nadmiernie rozbudowywać hierarchii, lepiej jest ją uprościć, jeśli nie jest konieczny głęboki podział.
- Części niesamodzielne tworzymy jako podstrony (czyli po ukośniku)
- W e-booku mamy do dyspozycji dwa poziomy hierarchii, jeśli potrzebujemy ich więcej, musimy odnośniki do więcej niż jednego poziomu umieścić na głównej lub na stronach rozdziałów
- ↑ Szablon {{Summary}} lub para szablonów {{SummaryStart}}/{{SummaryKoniec}}
- ↑ Należy zauważyć, że liczba ukośników w nazwie nie jest istotna, włączony zostanie zarówno nazwa strony głównej/jakaś podstrona jak i nazwa strony głównej/coś tam/jeszcze głębiej/następny poziom/strona do włączenia