Ŝablono:Bildgalerio/dokumentado

Plejofte, ne indas enigi bildgalerion se troviĝas sufiĉa spaco por enigi bildojn apud la teksto.

Ĉi tiu ŝablono provizas altnivelan helpilon por konstrui bildgaleriojn. Por krei ĝeneralajn bildgaleriojn, bv. uzi la etikedon <gallery>.

Ĉi tiu ŝablono montras galerion de bildoj en tabelo, de maldekstre dekstren en vicoj. La ĉieaj parametroj |larĝo= kaj |alto= kontrolas la grandecon de ĉiuj bildoj en la galerio. La nombro da bildoj por vico dependas ĉefe de la parametro |larĝo= kaj de la larĝo de la ekrano. La nombro da bildoj por vico povas ŝanĝiĝi se la uzanto (mal)grandigas la fenestron.

Sintakso

{{Bildgalerio | titolo = | vicigo = | porvico = | piednoto = | stilo = | stato = | alto = | larĝo = | apudskribo-stilo = | Dosiero: | <!--apudskribo ĉi tie--> | alt1= | Dosiero: | <!--apudskribo ĉi tie--> | alt2= | Dosiero: | <!--apudskribo ĉi tie--> | alt3= | Dosiero: | <!--apudskribo ĉi tie--> | alt4= | Dosiero: | <!--apudskribo ĉi tie--> | alt5= }}

Parametroj

Por ĉiu bildo

Enmetu vicon laŭ la jena aranĝo por ĉiu bildo.

|Dosiero:nomo de dosiero |Apudskribo |altn=alternativa teksto (malnepra)

Notu, ke kaj la nomo de la dosiero, kaj la apudskribo havas sennomajn parametrojn; tamen, ĉiu parametro de alternativa teksto estas enmetenda post la nomhava parametro |altn=.

Pli precize:

|Dosiero:Nomo de dosiero estas la nomo de la bildo.

|Apudskribo estas la apudskribo sub la bildo.

|altn=: |alt1= por la unua bildo, |alt2= por la dua bildo, ktp.

alternativa teksto estas la alternativa teksto por la bildo, uzata de vidhandikapuloj aŭ aliaj legantoj, kiuj ne povas klare vidi la bildon. Kiam ellasita, la alternativa teksto de la bildo estos malplena.

Nedevigaj parametroj

Ĉi tiuj parametroj validas por la tuta galerio:

• |titolo=: la titolo de la bildgalerio.
• |vicigo=: la vicigo de la galerio sur la paĝo, maldekstre (defaŭlte), centre aŭ dekstre; ignorata kiam uzatas |stato=.
• |porvico=: la maksimuma nombro de bildoj en ĉiu vico de la galerio (se la spaco en la paĝo sufiĉas).
• |piednoto=: malgranda, dekstren vicigita teksto sub la bildoj.
• |stilo=: CSS-stilaj direktivoj por la tuta galerio.
• |stato=: agordas la defaŭltan staton de kaŝeblaj galerioj; uzu |stato=vastigita aŭ |stato=kolapsita; vastigitaj galerioj okupas la tutan paĝlarĝon.
• |reĝimo=: agordas la reĝimon uzatan de la interna galeria etikedo. Oftaj valoroj inkluzivas: |reĝimo=pakita kaj |reĝimo=sen linioj
• |sen bordero=: forigas la borderon ĉirkaŭ la bildoj; uzu |sen bordero=jes por agordi ĝin.
• |blanka fono=: forigas la blankan fonon malantaŭ la bildoj; uzu |blanka fono=ne por agordi ĝin.
• |alto=: maksimuma alteco de ĉiu bildo. Se ĉi tiu parametro ne estas agordita, |alto= defaŭlte estas 180 bilderoj. Uzu simplan nombron ĉi tie, ekz., 200, sen unuonomo, ekz., 200px.
• |larĝo=: maksimuma larĝo de ĉiu bildo; defaŭlte estas 180 bilderoj. Uzu numeron ĉi tie, ekz., 150, sen unuoj, ekz., 150px.
• |apudskribo-stilo=: CSS-stilaj direktivoj por la apudskriboj.

Oni ne povas modifi la originalan proporcion de la bildo (larĝo por alto) per |larĝo= aŭ |alto=; ekzemple, ortangula bildo ne fariĝas kvadrata se |larĝo= kaj |alto= havas la saman valoron.

Ekzemploj

{{Bildgalerio
|titolo=Bildaro pri belaj katoj
|larĝo=160 | alto=170
|vicigo=centre
|piednoto=Ekzemplo 1
|porvico=3
|Dosiero:A cat that having blue and green eyes.jpg
 |Kato kiu havas bluan kaj verdan okulojn.
 |alt1=Kato kun diverskoloraj okuloj rigardas maldekstren.
|Dosiero:Tabby cat with blue eyes-3336579.jpg
 |Kato kun bluaj okuloj.
 |alt2=Kato kun longa hararo rigardas la spektanton.
|Dosiero:Cat yawning in park.jpg
 |La katoj estas foje [[dormo|dormemaj]] bestoj.
 |alt3=Kato oscedante en parko malfermas sian buŝon.
|Dosiero:Cat wearing sunglasses.jpg
 |Katoj estas dorlotbestoj.
 |alt4=Kato kun bluaj okulvitroj.
|Dosiero:Hannibal Poenaru - Nasty cat ! (by-sa).jpg
 |Kelkfoje eĉ katoj [[kolero|koleriĝas]].
 |alt5=Kolera kato kun malfermita buŝo.
|Dosiero:Chinchilla cat (5062381460).jpg
 |Kato ekhavas [[Psikologio|dubojn pri sia vivo]].
 |alt6=Kato kun longa hararo kaj verdaj okuloj.
}}

Bildaro pri belaj katoj

• 
  Kato kiu havas bluan kaj verdan okulojn.
• 
  Kato kun bluaj okuloj.
• 
  La katoj estas foje dormemaj bestoj.
• 
  Katoj estas dorlotbestoj.
• 
  Kelkfoje eĉ katoj koleriĝas.
• 
  Kato ekhavas dubojn pri sia vivo.

Ekzemplo 1

{{Bildgalerio
|titolo=Famaj statuoj el la mondo
|piednoto=Ekzemplo 2
|reĝimo=pakita-surmeto
|vicigo=centre
|Dosiero:Statue of Unity.jpg
  |Statuo de Unueco
  |alt1=La statuo estas portreto de Vallabhbhai Patel en tradiciaj vestaĵoj.
|Dosiero:Spring Temple Buddha 06.jpg
  |Budho de la Templo de la Fonto
  |alt2=La statuo portretas Budhon.
|Dosiero:Majestic Liberty.jpg
  |Statuo de Libereco
  |alt3=La statuo portretas virinon kiu estas alegorio pri libereco.
|Dosiero:Родина-мать зовёт!.svg
  |La patrujo alvokas!
  |alt4=La statuo portretas alegorion pri Rusio.
|Dosiero:Christ the Redeemer 1.jpg
  |Statuo pri [[Kristo]] Savinto
  |alt5=Statuo pri Jezuo Kristo ĉirkaŭbrakante la homaron.
|Dosiero:'David' by Michelangelo JBU0001.JPG
  |Statuo de [[David]]
  |alt6=Blanka statuo pri David el marmoro.
}}

Famaj statuoj el la mondo

• 
  Statuo de Unueco
• 
  Budho de la Templo de la Fonto
• 
  Statuo de Libereco
• 
  La patrujo alvokas!
• 
  Statuo pri Kristo Savinto
• 
  Statuo de David

Ekzemplo 2

{{Bildgalerio
|piednoto=Ekzemplo 3
|reĝimo=bildoserio
|vicigo=dekstre
|Dosiero:Statue of Unity.jpg
  |Statuo de Unueco
  |alt1=La statuo estas portreto de Vallabhbhai Patel en tradiciaj vestaĵoj.
|Dosiero:Spring Temple Buddha 06.jpg
  |Budho de la Templo de la Fonto
  |alt2=La statuo portretas Budhon.
|Dosiero:Majestic Liberty.jpg
  |Statuo de Libereco
  |alt3=La statuo portretas virinon kiu estas alegorio pri libereco.
|Dosiero:Родина-мать зовёт!.svg
  |La patrujo alvokas!
  |alt4=La statuo portretas alegorion pri Rusio.
|Dosiero:Christ the Redeemer 1.jpg
  |Statuo pri [[Kristo]] Savinto
  |alt5=Statuo pri Jezuo Kristo ĉirkaŭbrakante la homaron.
|Dosiero:'David' by Michelangelo JBU0001.JPG
  |Statuo de [[David]]
  |alt6=Blanka statuo pri David el marmoro.
}}

• 
  Statuo de Unueco
• 
  Budho de la Templo de la Fonto
• 
  Statuo de Libereco
• 
  La patrujo alvokas!
• 
  Statuo pri Kristo Savinto
• 
  Statuo de David

Ekzemplo 3

TemplateData

Tio ĉi estas dokumentado de TemplateData, kiu estas uzata de ŝablonoj per VidRedaktilo.

Bildgalerio

Enmetas stiligitan bildgalerion.

Ŝablonaj parametroj[Administri ŜablonDatumojn]

Parametro		Priskribo	Tipo	Stato
titolo	titolo	Titolo de la bildgalerio Ekzemplo Specioj de birdoj	Ĉeno	sugestata
vicigo	vicigo	Vicigo de la galerio sur la paĝo; eblaj valoroj inkluzivas: maldekstre, dekstre kaj centre Defaŭlta maldekstre Ekzemplo centre	Ĉeno	malnepra
porvico	porvico	Nombro de bildoj en ĉiu vico (se la spaco sufiĉas) Ekzemplo 3	Nombro	malnepra
piednoto	piednoto	Kreas piedlinion kiu aperos en la malsupra dekstra angulo de la galerio, en malgranda fonto; la redaktoro povas enmeti kian ajn tekston. Ekzemplo Fotoj de sinjoro L. L. Zamenhof	Ĉeno	malnepra
stilo	stilo	Ebligas specifi CSS-stilan kodon	Nekonata	malnepra
apudskribo-stilo	apudskribo-stilo	Ebligas specifi CSS-stilan kodon por la apudskriboj	Nekonata	malnepra
stato	stato	Ĉi tiu parametro permesas al la redaktisto determini ĉu la bildgalerio komence aperos aŭ vastigita aŭ kolapsita por la legantoj. Suggested values vastigita kolapsita Defaŭlta vastigita Ekzemplo kolapsita	Ĉeno	malnepra
alto	alto	Determinas la maksimuman altecon por ĉiu bildo en la galerio Defaŭlta 180 Ekzemplo 100	Nombro	malnepra
larĝo	larĝo	Determinas la maksimuman larĝon por ĉiu bildo en la galerio Defaŭlta 180 Ekzemplo 100	Nombro	malnepra
reĝimo	reĝimo	Agordas la reĝimon uzatan de la interna galeria etikedo Suggested values tradicia sen linioj pakita pakita-surmeto pakita-musumo bildoserio Defaŭlta tradicia	Ĉeno	malnepra
sen bordero	sen bordero	Forigas la borderon ĉirkaŭ la bildoj Defaŭlta ne Ekzemplo jes	Logika valoro	malnepra
blanka fono	blanka fono	Uzata por forigi la blankan fonon en la interna galeria etikedo Defaŭlta jes Ekzemplo ne	Logika valoro	malnepra

Spuradaj kategorioj

• Paĝoj uzantaj bildgalerion kun parametro apudskribo-stilo
• Paĝoj uzantaj bildgalerion kun nekonataj parametroj