InterWiki: historyczna wersja

To jest stara wersja strony z , edytowana przez użytkownika 🍬. Może się ona różnić od obecnej wersji.

Podgląd

To jest dokumentacja pliku https://wandystan.eu/varia/intermap.txt

Spis treści

Co to jest InterWiki?

InterWiki to metoda linkowania do artykułów znajdujących się na innych stronach typu wiki przy użyciu krótkiego wyróżnika danego wiki. Przykładowo, używając składni typu [[Example:Tytuł strony]] (MediaWiki, PmWiki), [[Example>Tytuł strony]] (System Stron Wandejskich, DokuWiki), czy Example:"Tytuł strony" (UseModWiki) możemy zalinkować do artykułu znajdującego się pod adresem https://example.org/wiki/Tytuł_strony.

Główną zaletą takiego sposobu linkowania jest to, że jeżeli adres podlinkowanej witryny zmieni się, niepotrzebna jest aktualizacja odnośników na każdej stronie.

Niniejsza strona używa ekstensywnie odnośników InterWiki w celach demonstracyjnych. Są one (tylko na tej stronie) oznaczone poprzedzającą gwiazdką (*).

Czym jest plik intermap.txt?

Jest to plik, w którym zawarte są wyróżniki mikronacyjnych stron typu wiki (ale nie tylko), wraz z prefiksami oraz sufiksami dołączanymi do tytułu artykułu, aby uzyskać jego adres strony internetowej.

Składa się on z oddzielonych znakami nowej linii rekordów, składających się z oddzielonych znakiem spacji kolejno:

  1. Wyróżnika strony, zaczynającego się wielką literą i zawierającego jedynie bezdiakrytyczne znaki alfabetu łacińskiego oraz kropki;
  2. Prefiksu adresu strony internetowej;
  3. (opcjonalnie) Sufiksu adresu strony internetowej.

Dodatkowo, w pierwszej linijce zawsze zamieszczony jest adres niniejszego artykułu dokumentującego ten plik. Linijka ta jako jedyna zawsze zaczyna się kropką.

Format pliku jest zgodny z formatem InterMap używanym m. in. przez UseModWiki.

Jak używać pliku intermap.txt?

Należy ustawić cykliczne wykonywanie skryptu (np. za pomocą crona, czasomierzy systemd), który:

  1. Pobiera plik intermap.txt z https://wandystan.eu/varia/intermap.txt;
  2. Konwertuje go na format właściwy dla zainstalowanego systemu wiki (alternatywnie: wstawia dane w nim zawarte do bazy danych);
  3. Zapisuje go we właściwej lokalizacji.

Przykład takiego skryptu można znaleźć poniżej:

#! /bin/sh
#
# Any copyright is dedicated to the Public Domain.
# http://creativecommons.org/publicdomain/zero/1.0/
#
target=/path/to/the/wiki/installation/localmap.txt
trap 'rm -f "$target.tmp"' EXIT

test "$(
    exec 3>&1
    {
        curl -fsS https://wandystan.eu/varia/intermap.txt
        echo $? >&3
    } | tail -n +2 | while IFS=' ' read -r moniker prefix suffix
    do
        # Change the line below to fit your wiki system
        printf '%s: %s$1%s\n' "$moniker" "$prefix" "$suffix"
    done > "$target.tmp"
)" -eq 0 || exit 1
mv -f "$target.tmp" "$target"

Innym przykładem takiego skryptu jest intermap2php używany przez System Stron Wandejskich i wywoływany za pomocą następującej reguły make:

include.interwiki.php: ../varia/intermap.txt helpers/intermap2php
    helpers/intermap2php < $< > $@

Po co to wszystko?

Inspiracją do stworzenia ujednoliconego wykazu wyróżników InterWiki były wielokrotnie podnoszone pomysły na utworzenie nowej mikroświatowej encyklopedii oraz biblioteki. Jednocześnie, wiele krajów posiada już swoje własne encyklopedie i biblioteki, których raczej nie będą chciały się pozbyć. W niektórych krajach podejmowane są także działania mające w zamiarze utworzenie nowych tego rodzaju zbiorów, jak np. Nowa Biblioteka im. św. Róży. Dlatego też przydatna byłaby możliwość łatwego tworzenia odnośników między nimi.

Liczę na to, że dzięki temu np. strona w Encyklopedii Wandejskiej o Dreamlandzie https://wandystan.eu/w/Encyklopedia::Dreamland, zamiast posiadać dziesiątki czerwonych linków do artykułów, które raczej u nas szybko nie powstaną, będzie mogła linkować po prostu do encyklopedii dreamlandzkiej.

I oczywiście także w drugą stronę: encyklopedia dreamlandzka, zamiast duplikować tematy już zawarte w Encyklopedii Wandejskiej, będzie po prostu posiadała linki do stron Wandystanu. Dlatego też Komisariat Ludowy do spraw Informatycznych pracuje obecnie nad udostępnieniem ujednoliconej bazy prefiksów interwiki, z którą inne mikronacje będą mogły po prostu się synchronizować. Mam nadzieję, że z tego skorzystają.

Warto także zacytować opinię tow. Radzieckiego w tej kwestii:

No to jest mega (…) zajebiste. Przyznam że sporo bym dał za taką metodę jak bawiłem się w v-encyklopedie (łącznie że trzy czy cztery nie licząc Wandejskiej) i zawsze potykałem się o problem uzupełniania danych z i o innych krajach.