Malline:Arkistolinkit/ohje

Malline tuottaa automaattisesti linkit sivun numeroituihin arkistoihin. Se toimii oletusarvoillaan mallinekutsulla {{Arkistolinkit}}, jos arkistosivujen nimet ovat muodossa Arkistoitava sivu/Arkisto 1 – siis iso A-kirjain sanassa Arkisto, välilyönti ennen numeroa eikä nollia arkistonumeron edessä. Tässä ohjeessa kerrotaan, miten oletuksia voi muuttaa. Mallinetta ei ole tarkoitus substata, koska substaamaton malline päivittää arkistolinkkien luetteloa automaattisesti sitä mukaa, kun uusia arkistosivuja luodaan.

Käyttöohje

Jos arkistosivut ovat muotoa Jokin/Arkisto X ja niiden numerointi alkaa ykkösestä, saa sivulle Jokin kaikkiin sen arkistoihin osoittavat linkit yksinkertaisesti kutsumalla mallinetta ilman mitään parametreja: {{Arkistolinkit}}

Esimerkiksi omalla keskustelusivulla oletusmuotoiset linkit sen arkistoihin saa aikaan mallinekutsulla {{Arkistolinkit}}, jos keskustelusivun arkistot on nimetty tyyliin Keskustelu käyttäjästä:Jaska Jokunen/Arkisto X ja numerointi juoksee 1, 2, 3... {{Arkistolinkit|ensimmäinen=Y}} puolestaan listaa linkit alkaen arkistonumerosta Y, jonka tilalle voi sijoittaa ensimmäisen arkistointivuoden, jos arkistot on nimetty vuosien perusteella tyyliin Keskustelu käyttäjästä:Jaska Jokunen/Arkisto 2006. Mikäli arkistosivujen nimissä ei käytetä välilyöntejä vaan ne ovat muodossa ArkistoX, saa oletusmuotoiset arkistolinkit aikaan mallinekutsulla {{Arkistolinkit|väli=ei}} tai {{Arkistolinkit|väli=ei|ensimmäinen=Y}}.

Arkistojen linkitykset voi siis aloittaa tietynnumeroisesta arkistosta, ja ne voi myös lopettaa tiettyyn arkistoon. Esimerkkejä:
{{Arkistolinkit|ensimmäinen=4}}
{{Arkistolinkit|viimeinen=7}}
{{Arkistolinkit|ensimmäinen=4|viimeinen=7}}

Parametrilla ensimmäinen voidaan säätää sitä, mistä arkistonumerosta luettelo lähtee liikkeelle (yllä olevan mallinekutsun tuottama listaus alkaa siis arkistosta 4). Siitä alkaen linkit olemassaoleviin arkistoihin muodostetaan automaattisesti. Kyseinen parametri on hyödyllinen esimerkiksi silloin, jos numerointi poikkeaa normaalista tai jos manuaalisesti tehtyä linkkiluetteloa jatketaan automatisoiduilla arkistolinkeillä. Yleensä parametria viimeinen ei kannata määrittää, koska se poistaa käytöstä automaattisen linkityksen uusiin arkistoihin.

Esimerkit arkistonumerosta 4 aloittamisesta sekä arkistosta 4 arkistoon 7 linkittämisestä, jos arkistojen nimissä ei käytetä välilyöntejä sanan Arkisto jälkeen:
{{Arkistolinkit|väli=ei|ensimmäinen=4}}
{{Arkistolinkit|väli=ei|ensimmäinen=4|viimeinen=7}}

Parametria juuri käyttämällä on mahdollista muodostaa tietyn sivun arkistoihin osoittavat linkit millä tahansa sivulla. Esimerkiksi linkit ylläpitäjien ilmoitustaulun arkistoihin saa aikaan missä tahansa käyttämällä seuraavaa koodia:
{{Arkistolinkit|juuri=Wikipedia:Ylläpitäjien ilmoitustaulu}}

Parametrit

Mikään parametreista ei ole pakollinen ja harvoja poikkeuksia lukuun ottamatta niitä voi yhdistellä vapaasti. Kaikki käytettävissä olevat parametrit sisältävä mallinekutsu:

{{Arkistolinkit
| juuri            = 
| linkkejä         = 
| eirivinvaihtoja  = 
| etuliite         = 
| väli             = 
| linkkietuliite   = 
| linkkiväli       = 
| erotin           = 
| rivierotin       = 
| ensimmäinen      = 
| viimeinen        = 
| taulukkona       = 
}}


Parametri	Kuvaus	Esimerkkiarvo
juuri	Arkistoitava sivu. Käytä tätä parametria, jos haluat linkittää jonkin muun kuin sen sivun arkistoihin, johon malline sisällytetään.	Wikipedia:Ylläpitäjien ilmoitustaulu
linkkejä	Yhdellä rivillä näytettävien linkkien lukumäärä.	12
eirivinvaihtoja	Aseta tämän parametrin arvoksi kyllä, jos haluat poistaa kaikki rivinvaihdot. Muussa tapauksessa jätä kohta tyhjäksi tai jätä parametri kokonaan pois mallinekutsusta. Parametria `eirivinvaihtoja` ei voi käyttää yhdessä parametrin `linkkejä` kanssa.	kyllä
etuliite	Arkiston etuliite, joka on oletusarvoisesti `Arkisto`.	Arkisto
väli	Jos arkiston etuliitteen ja numeron välissä ei ole välilyöntiä, aseta tämän parametrin arvoksi ei. Muussa tapauksessa jätä kohta tyhjäksi tai jätä parametri kokonaan pois mallinekutsusta.	ei
linkkietuliite	Etuliite näkyville arkistolinkeille. Oletusarvoisesti arkistonumeroiden edellä ei näytetä mitään etuliitettä.	Arkisto
linkkiväli	Jos olet asettanut parametrille `linkkietuliite` jonkin arvon etkä halua välilyöntiä näytöllä näkyvän etuliitteen ja arkistonumeron välille, aseta tämän parametrin arvoksi ei. Kaikissa muissa tapauksissa jätä tämä kohta tyhjäksi tai jätä parametri kokonaan pois mallinekutsusta.
erotin	Erotin arkistolinkkien välillä. Oletuksena käytetään sen kielen pilkkuerotinta, jonka olet valinnut asetuksissa käyttöliittymän kieleksi. Jos parametrille `erotin` asetetaan jokin muu arvo, sitä käytetään sellaisenaan.	•
rivierotin	Linkkirivit toisistaan erottava wikiteksti. Oletusarvona on <br />.
ensimmäinen	Arkistonumero, josta arkistojen listaaminen aloitetaan. Tämän täytyy olla pienempi kuin suurin arkistonumero tai `viimeinen`-parametrin arvo, jos se on määritetty.	5
viimeinen	Arkistonumero, johon arkistojen listaaminen lopetetaan. Tämän parametrin käyttö saa aikaan sen, että arkistosivujen automaattinen tunnistus ohitetaan.	15
taulukkona	Jos haluat, että malline tuottaa taulukkomuotoisen esityksen, aseta tämän parametrin arvoksi kyllä. Silloin myös parametrille `linkkietuliite` kannattaa asettaa jokin arvo. Muussa tapauksessa sen arvoksi tulee taulukkona-parametrin käytön myötä Arkisto. Jos et halua mallineen tuottavan taulukkoa, jätä tämä kohta tyhjäksi tai jätä parametri kokonaan pois mallinekutsusta.

Käyttöesimerkkejä

Keskustelu käyttäjästä

{{Arkistolinkit|juuri=Keskustelu käyttäjästä:Zache|väli=ei}}
Lopputulos:
1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93

{{Arkistolinkit|juuri=Keskustelu käyttäjästä:Ejs-80|ensimmäinen=3}}
Lopputulos:
3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13

{{Arkistolinkit
| juuri            = Keskustelu käyttäjästä:Zache
| linkkejä         = 9
| eirivinvaihtoja  = 
| etuliite         = 
| väli             = ei
| linkkietuliite   = Arkisto
| linkkiväli       = 
| erotin           = 
| rivierotin       = 
| ensimmäinen      = 
| viimeinen        = 36
| taulukkona       = kyllä
}}

Yllä oleva esimerkki taulukoi linkit ja lopettaa listaamisen arkistoon 36. Tässä tapauksessa arkistosivujen nimissä ei ole välilyöntiä Arkisto-sanan ja numeron välissä, kun taas mallineen tuottamaan linkkiluetteloon ne tulevat. Kullekin riville sisällytetään 9 linkkiä. Lopputulos:

Arkisto 1	Arkisto 2	Arkisto 3	Arkisto 4	Arkisto 5	Arkisto 6	Arkisto 7	Arkisto 8	Arkisto 9
Arkisto 10	Arkisto 11	Arkisto 12	Arkisto 13	Arkisto 14	Arkisto 15	Arkisto 16	Arkisto 17	Arkisto 18
Arkisto 19	Arkisto 20	Arkisto 21	Arkisto 22	Arkisto 23	Arkisto 24	Arkisto 25	Arkisto 26	Arkisto 27
Arkisto 28	Arkisto 29	Arkisto 30	Arkisto 31	Arkisto 32	Arkisto 33	Arkisto 34	Arkisto 35	Arkisto 36

{{Arkistolinkit
| juuri            = Keskustelu käyttäjästä:Ejs-80
| linkkejä         = 1
| eirivinvaihtoja  = 
| etuliite         = 
| väli             = 
| linkkietuliite   = Vanhat viestit, osa 
| linkkiväli       = 
| erotin           = 
| rivierotin       =
| ensimmäinen      = 8
| viimeinen        = 
| taulukkona       = 
}}

Yllä oleva esimerkki aloittaa luetteloinnin arkistosta 8 ja käyttää omavalintaista ”Vanhat viestit” -alkuista erotinta. Kullekin riville sisällytetään ainoastaan yksi linkki. Lopputulos:
Vanhat viestit, osa 8
Vanhat viestit, osa 9
Vanhat viestit, osa 10
Vanhat viestit, osa 11
Vanhat viestit, osa 12
Vanhat viestit, osa 13

Ilmoitustaulu

{{Arkistolinkit
| juuri            = Wikipedia:Ylläpitäjien ilmoitustaulu
| linkkejä         = 30
| eirivinvaihtoja  = 
| etuliite         = 
| väli             = 
| linkkietuliite   = 
| linkkiväli       = 
| erotin           = &nbsp;•&nbsp;
| rivierotin       = 
| ensimmäinen      = 
| viimeinen        = 
| taulukkona       = 
}}

Yllä olevassa esimerkissä käytetään omavalintaista erotinta linkkien välillä ja yhdelle riville sisällytetään korkeintaan 30 linkkiä. Lopputulos:
1 • 2 • 3 • 4 • 5 • 6 • 7 • 8 • 9 • 10 • 11 • 12 • 13 • 14 • 15 • 16 • 17 • 18 • 19 • 20 • 21 • 22 • 23 • 24 • 25 • 26 • 27 • 28 • 29 • 30
31 • 32 • 33 • 34 • 35 • 36 • 37 • 38 • 39 • 40 • 41 • 42 • 43 • 44 • 45 • 46 • 47 • 48 • 49 • 50 • 51 • 52 • 53 • 54 • 55 • 56 • 57 • 58 • 59 • 60
61 • 62 • 63 • 64 • 65 • 66 • 67 • 68 • 69 • 70 • 71 • 72 • 73 • 74 • 75 • 76 • 77 • 78 • 79 • 80 • 81 • 82 • 83 • 84 • 85

{{Arkistolinkit
| juuri            = Wikipedia:Ylläpitäjien ilmoitustaulu
| linkkejä         = 6
| eirivinvaihtoja  = 
| etuliite         = 
| väli             = 
| linkkietuliite   = A
| linkkiväli       = ei
| erotin           = 
| rivierotin       = 
| ensimmäinen      = 9
| viimeinen        = 26
| taulukkona       = kyllä
}}

Yllä oleva esimerkki luettelee ainoastaan arkistot 9–26 ja esittää linkit taulukkomuodossa. Näkyvien linkkien etuliitteenä käytetään A-kirjainta, ja sen ja arkistonumeron välissä ei näytetä välilyöntiä. Kullekin riville tulee kuusi linkkiä. Lopputulos:

A9	A10	A11	A12	A13	A14
A15	A16	A17	A18	A19	A20
A21	A22	A23	A24	A25	A26

Kahvihuone

{{Arkistolinkit
| juuri            = Wikipedia:Neuvonta
| etuliite         = arkisto
| väli             = ei
| ensimmäinen      = 1
| viimeinen        = 6
}}, {{Arkistolinkit
| juuri            = Wikipedia:Neuvonta
| ensimmäinen      = 7
| viimeinen        = 9
}}, {{Arkistolinkit
| juuri            = Wikipedia:Kahvihuone (kysy vapaasti)
| ensimmäinen      = 10
}}

Käsitellään lopuksi hiukan mutkikkaampaa tapausta, jossa kahvihuone on historian saatossa muuttanut alkuperäistä nimeään Wikipedia:Neuvonta, jonka tilalle on kymmenennen arkiston kohdalla tullut nimi Wikipedia:Kahvihuone (kysy vapaasti). Lisäksi arkistosivujen 1–6 nimissä arkisto-etuliitteessä on käytetty pientä a-kirjainta, kun taas arkistosta 7 lähtien etuliitteessä on käytetty arkistojen nimissä yleisempää isoa alkukirjainta. Arkisto 7 on myös ollut ensimmäinen, jossa on käytetty välilyöntiä arkisto-etuliitteen ja -numeron välissä.

Lopputulos:
1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64