summaryrefslogtreecommitdiff
path: root/ikiwiki/blog.mdwn
blob: 505c72c13cbfd39916007b6826a2c73b9dc51b15 (plain)

[[!meta robots="noindex, follow"]] [[!if test="enabled(inline)" then="Denne wiki har inline plugin aktiveret." else="Denne wiki har inline plugin deaktiveret."]]

[[!if test="enabled(inline)" then="Du kan" else="Hvis denne wiki havde inline plugin aktiveret, kunne du"]] omlægge enhver side på denne wiki til en weblog ved at bruge [[direktivet|directive]] inline. Som eksempel:

\[[!inline pages="blog/* and !*/Discussion" show="10" rootpage="blog"]]

Enhver side der modsvarer det angivne [[PageSpec]] (i eksemplet enhver [[UnderSide|SubPage]] til "blog") vil blive del af bloggen, og de nyeste 10 af dem vil dukke op på siden. Bemærk at hvis filer som ikke er sider modsvarer [[PageSpec]]'et, bliver de medtaget i fødningen (feed) gennem RSS-indkapslinger, som er anvendeligt til podcasting.

Den valgfri rootpage-parameter fortæller wikien at nye indlæg til denne blog som standard skal være [[UnderSider|SubPage]] til "blog", og aktiverer en formular øverst i bloggen som kan bruges til at tilføje nye emner.

Hvis du har lyst til at din blog skal have en arkivside med oversigt over alle indlæg skrevet nogensinde til den, kan det gøres sådan her:

\[[!inline pages="blog/* and !*/Discussion" archive="yes"]]

Du kan endda lave en automatisk dannet liste over alle de sider på wikien, med de nyeste tilføjet øverst, sådan her:

\[[!inline pages="* and !*/Discussion" archive="yes"]]

Hvis du vil have mulighed for at tilføje sider til en given blogfødning ved at mærke dem af, kan du også gøre det. Du afmærker en side ved blot at lave en henvisning til en en eller flere sider som repræsenterer dets mærkater. Brug derefter det særlige link() [[PageSpec]] til at modsvare alle sider med en given mærkat:

\[[!inline pages="link(life)"]]

Eller medtag nogle mærkater og udelad andre:

\[[!inline pages="link(debian) and !link(social)"]]

brug

Der er mange parametre du kan bruge med inline-direktivet. Disse er de oftest brugte:

  • pages - Et [[PageSpec]] af siderne at indlejre.
  • show - Angiver det maksimale antal modsvarende sider at indlejre. Standard er 10, på nær arkivering, hvor standarden er at vise alle. Sæt til 0 for at vise alle modsvarende sider.
  • archive - Hvis "yes" er angivet, så vis kun sidetitler og nogle metadata, ikke det samlede indhold.
  • description - Angiver beskrivelsen til rss-fødningen hvis en dannes. Som standard bruges wikiens navn.
  • skip - Angiv et antal sider at springe over ved visning. Kan være nyttigt til at danne en fødning som kun viser arkiverede sider.
  • postform - Angiv "yes" for at aktivere en formular til at indsende nye sider til en [[blog]].
  • postformtext - Angiv den tekst som skal vises i en indsendelsesformular (postform).
  • rootpage - Aktiverer indsendelsesformularen (postform) og gør det muligt at styre hvor nye indlæg ender, ved at angive siden som de skal være en [[UnderSide|subpage]] af.

Her er nogle parametre der ikke så tit er nødvendige at bruge:

  • actions - Hvis angivet som "yes" tilføjes henvisninger nedenfor de indlejrede sider til redigering og diskussion (hvis de ville blive vist foroven på selve siden).
  • rss - Styrer dannelse af en rss-fødning. Hvis wikien er opsat til at danne rss-fødninger som standard, deaktiveres ved at angive "no". Hvis wikien er opsat til allowrss, aktiveres ved at angive "yes".
  • atom - Styrer dannelse af en atom-fødning. Hvis wikien er opsat til at danne atom-fødninger som standard, deaktiveres ved at angive "no". Hvis wikien er opsat til allowatom, aktiveres ved at angive "yes".
  • feeds - Styrer dannelse af alle typer af fødninger. Angiv "no" for at deaktivere dannelse af nogen fødninger.
  • template - Angiver skabelonen der udfyldes ved visning af hver indlejret side. Som standard bruges inlinepage-skabelonen, mens archivepage-skabelonen bruges til arkiver. Brug denne parameter til at bruge en anden skabelon end normalt, for eksempel titlepage-skabelonen som kun viser indlægs titler. Bemærk at du stadigt bør angive archive=yes hvis din skabelon ikke medtager sideindholdet.
  • raw - I stedet for som standard at lave en [[blog]], vil siden, når raw angives som "yes", inkluderes råt, uden yderligere opmærkning omkring den, som om den var en integreret den af kildekoden til den indlejrende side.
  • sort - Styrer hvordan indlejrede sider sorteres. Standarden, "age", sorterer nyest oprettede sider først. Angives "title" sorteres siderne efter titel, og "mtime" sorterer nyest redigerede sider først.
  • reverse - Hvis du angiver "yes", sorteres i omvendt rækkefølge.
  • feedshow - Angiver det maksimale antal modsvarende sider at medtage i rss/atom-fødninger. Standarden er den samme som show-værdien ovenfor.
  • feedonly - Dan kun fødninger, vis ikke siderne indlejret på siden.
  • quick - Opbyg arkiver i hurtigmodus, uden at læse siderne igennem efter metadata. som standard deaktiverer dette også dannelse af alle fødninger.
  • timeformat - Brug denne til at angive hvordan tiden eller datoen vises for sider i bloggen. Formateringsstrengen videregives til funktionen strftime(3).
  • feedpages - Et [[PageSpec]] af indlejrede sider som medtages i rss/atom- fødninger. Standarden er den sammen som for pages-værdien ovenfor, og kun sider som modsvarer dén værdi medtages, men nogle af dem kan udelades ved at angive et mere snævert [[PageSpec]] her.
  • guid - Hvis en URI er angivet her (måske en UUID med urn:uuid: foran), vil Atom-fødningerne have dette som dets <id>. Standarden er at bruge URLen for siden som indeholder inline-direktivet.