Makroer
Makroer giver mulighed for at indsætte systemfunktioner i normale wiki-sider; det eneste særlige ved disse sider er at de indeholder makroer. Hvis du prøver at redigere en side som SenesteRettelser eller SystemInfo, vil du se hvad dette betyder.
For mere information om mulig opmærkning, se HjælpTilRedigering.
Søgemakroer
MoinMoin anvender nu en ny søgerutine, som lader dig foretage sofistikerede søgninger både med det interaktive søgefelt og enhver af søgemakroerne. For mere hjælp, se HjælpTilSøgning.
Makro |
Beskrivelse |
Eksempel |
<<TitleSearch>> |
||
|
opretter et søgefelt på en side, som gennemsøger sidetitler |
Se FindSide |
<<FullSearch>> |
||
|
opretter et søgefelt på en side, som gennemsøger siders sider |
See FindSide |
<<FullSearch()>> |
||
|
viser en liste af sider hvis indhold matcher den nuværende sides titel (som at klikke på sidetitlen) |
|
<<FullSearch(tekst)>> |
||
|
viser en liste af sider hvis indhold matcher søgningen |
Søgning efter drevet: |
<<FullSearchCached(tekst)>> |
||
|
Fungerer lissom FullSearch makroen, men husker resultater statisk. Brug den hvis du foretrækker hastighed over opdaterede resultater |
Søgning efter drevet: |
<<GoTo>> |
||
|
går direkte til den side du angiver |
Se FindSide |
<<PageList(sidetitel-brudstykke)>> |
||
|
viser en liste af sider hvis titler matcher søgningen |
Se HjælpIndhold |
Navigering
Makro |
Beskrivelse |
Eksempel |
<<RecentChanges>> |
||
|
en liste over nyligt redigerede sider |
|
<<TitleIndex>> |
||
|
en oversigt over alle sidetitler |
Se TitelListe |
<<WordIndex>> |
||
|
en oversigt over alle ord i sidetitler |
Se OrdListe |
<<WantedPages>> |
||
|
viser henvisninger til ikke-eksisterende sider |
Se ØnskedeSider |
<<OrphanedPages>> |
||
|
viser sider som ingen andre sider henviser til |
|
<<AbandonedPages>> |
||
|
viser sider som i længst tid har været uredigerede |
|
<<RandomPage>> |
||
|
henviser til en tilfældig side |
|
<<RandomPage(#)>> |
||
|
viser et antal tilfældige sider |
To tilfældige sider: |
<<TableOfContents([maksdybde])>> |
||
|
opstiller en lokal indholdsfortegenelse, eventuelt begrænset til en maksimal dybde |
Se ovenfor |
<<Anchor(ankernavn)>> |
||
|
makro til at indsætte et anker i en side |
|
<<Navigation(børn[,maksdybde])>> |
||
|
makro til at vise alle en sides "børn" |
Se øverst på HelpOnMacros |
<<Navigation(søskende[,maksdybde])>> |
||
|
hurtig navigering til en sides "søskende" (samme niveau undersider) |
|
<<Navigation(slideshow)>> |
||
|
laver en henvisning til at skifte mellem slideshow og wiki modus, og en henvisning til at starte slideshowet |
|
<<Navigation(slides)>> |
||
|
viser første/forrige/næste/sidste henvisninger |
See HelpOnSlideShows |
<<AttachInfo>> |
||
|
viser antal vedhæftede filer for den nuværende side |
|
<<AttachInfo(sidenavn)>> |
||
|
viser antal vedhæftede filer for en side |
|
<<AttachList>> |
||
|
viser en liste over vedhæftede filer for den nuværende side |
|
<<AttachList(sidenavn)>> |
||
|
viser en liste over vedhæftede filer for en side |
Systeminformation
Makro |
Beskrivelse |
Eskempel |
<<InterWiki>> |
||
|
en liste over alle kendte InterWiki navne |
|
<<SystemInfo>> |
||
|
info om wiki'en, python-oversætteren og værtssystemet |
|
<<PageCount(exists)>> |
||
|
nuværende sideoptælling. Hvis exists tilføjes som et argument, vises kun sider som eksisterer. |
2042 sider |
<<PageSize>> |
||
|
viser en liste over størrelse af alle sider |
|
<<StatsChart(type)>> |
||
|
viser statistiske diagrammer (nuværende definerede typer: hitcounts, pagesize, useragents) |
Se HændelseStatistik og undersider |
<<SystemAdmin>> |
||
|
Information for systemadministratorer |
Kræver administrationsrettigheder. |
Andet
Makro |
Beskrivelse |
Eksempel |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
<<ImageLink(billede,mål[,width=bredde[,height=højde]][,alt="alternativ tekst"])>> |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Denne makro anvendes til at lave en henvisning som viser et billede (enten vedhæftet eller en URL) og henviser til enten en URL eller en wikiside. Valgfrit kan størrelsen på billedet justeres. Hvis intet mål angives, vil billedet henvise til sig selv. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||
<<Icon(piktogram)>> |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
vis systempiktogrammer |
See HelpOnNavigation |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
<<UserPreferences>> |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
viser en brugerprofil-dialog |
Se BrugerProfil |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
<<UserPreferences(createonly)>> |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
viser brugeroprettelsesdialog |
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
<<BR>> |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
indsætter et linjeskift |
1. linje |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
<<RandomQuote(sidenavn)>> |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Vælger et tilfældigt citat fra en given side, eller fra LykkeKager hvis udeladt (eller fra FortuneCookies, afhængigt af opsætning) |
Hint: View the edit history on the RecentChanges page by clicking the icon (for information). |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
<<Include(HelloWorld[,"heading"[,level]])>> |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
inkluderer indhold fra en anden side |
for detailer se HelpOnMacros/Include |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
<<FootNote(tekst)>> |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Tilføjer en fodnote1, eller viser opsamlede fodnoter når ingen argumenter er angivet |
Se nedenfor for et eksempel |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
<<Date(tidsstempel)>> |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
viser et tidsstempel ifølge systemopsætningen |
2024-11-16 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
<<DateTime(tidsstempel)>> |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
viser et tidsstempel2 ifølge brugerprofil |
2024-11-16 02:06:10 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
<<GetText(tekst)>> |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
indlæser I18N tekster (primært til brug i hjælpesider) |
"EditText" er oversat til "EditText" |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
<<TeudView>> |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
anvendeligt for intranet udvikler-wiki'er, beregnet til at vise pydoc dokumentation, formatteret via et XSLT stilark |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||
<<MailTo(email)>> |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Sikrer din email-adresse imod spam bots |
for detaljer se HelpOnMacros/MailTo |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
<<NewPage(SideSkabelon,KnapMærkat,OverliggendeSide[,NavneSkabelon])>> |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Giver brugeren mulighed for nemt at oprette (under)sider, vha. en SideSkabelon som skabelon for den nye side og tekststrengen NavneSkabelon som skabelon for den nye sides navn.3 |
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
<<GetVal(Opslagsside,term)>> |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Hent opslag fra opslagssider |
Hvis du har en side kaldet DanishDict som indeholder en definition på Test, skulle du kunne se en oversættelse her: |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{{
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Viser en kalender og opretter henvisninger til hver dag som undersider |
teksten kan ikke wiki-opmærkning (1)
"tidsstempel" kan udelades (nuværende tid), være antal sekunder siden 1970 (unix tidsstempel), eller en W3C tidsspecifikation ("2002-01-23T12:34:56"). Se RFC822, sect. 5. (2)
NavneSkabelon er formateret med time.strftime(), undtagen %s som erstattes med redigeringsfeltet (som kun vises hvis det er nødvendigt). Hvis NavneSkabelon ikke er angivet eller tomt, falder tilbage til %s. (3)
Skriv din egen makro
Opret en fil kaldet MakroNavn.py under din data/plugin/macro mappe. Sørg for at den har en enkelt metode kaldet execute(macro, arguments), som er startstedet.
macro er en instans af klassen Macro, og evaluerer også til en streng af makronavnet.
arguments er et arbitrært argument du kan sende ind med parametre til din makro.
Alle Macro instanser har et request medlem som du kan tilgå formularparametre igennem, og andre informationer relateret til bruger-interaktion.
execute() bør bruge en formateringsrutine til at konstruere korrekt opmærkning til målformatet. I de fleste tilfælde er dette HTML, så at skrive en makro som returnerer HTML vil fungere i de fleste tilfælde men fejle når formater som XML eller text/plain forespørges.
For eksempel, hvis din wikiside indeholder følgende linje:
<<MakroNavn(arg1,arg2,arg3)>>
Så kunne du skrive en MakroNavn.py fil som denne:
Tilføj et emne til Dependencies hvis uddata fra din makro ikke skal caches. Dette er vigtigt if makro-uddata kan ændre sig fra et øjeblik til det næste, for eksempel hvis din makro søger i wikisider som måske bliver redigeret af andre brugere, eller indlæser information fra en ekstern database med indhold som ændrer sig. I øjeblikket er værdien og navn på emnet uden betydning, og kan betragtes som en kort beskrivelse af 'hvorfor resultater af denne makro ikke skal caches', men kig venligst på emner anvendt i andre makroer for værdier som kan være passende.