Pomoc:Mechanizm działania eksportera
 |
Uwaga! Strona jest w trakcie opracowywania. Niektóre informacje mogą być niepełne, a linki mogą kierować do nieistniejących stron. Strona w opracowaniu zgodnie z ustaleniami w Skryptorium. |
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?
- 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)[1]. 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
- ↑ 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