HjælpTilMakroer – GNOME Wiki Archive

Contents

Makroer

1. 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.

1.1. 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)	Se KategoriKategori
`[[FullSearch(tekst)]]`
	viser en liste af sider hvis indhold matcher søgningen	Søgning efter `drevet`: HjælpTilMakroer
`[[FullSearchCached(tekst)]]`
	Fungerer lissom `FullSearch` makroen, men husker resultater statisk. Brug den hvis du foretrækker hastighed over opdaterede resultater	Søgning efter `drevet`: HjælpTilMakroer
`[[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

1.2. Navigering

Makro	Beskrivelse	Eksempel
`[[RecentChanges]]`
	en liste over nyligt redigerede sider	Se SenesteRettelser
`[[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	Se ForældreløseSider
`[[AbandonedPages]]`
	viser sider som i længst tid har været uredigerede	Se EfterladteSider
`[[RandomPage]]`
	henviser til en tilfældig side	Engagement/TeamMeetings/24-April-2020
`[[RandomPage(#)]]`
	viser et antal tilfældige sider	To tilfældige sider: Accessibility/Minutes/20100701 GnomeAsia/Minutes/20190709
`[[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	#her
`[[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)	Se HelpOnMacros/MailTo
`[[Navigation(slideshow)]]`
	laver en henvisning til at skifte mellem slideshow og wiki modus, og en henvisning til at starte slideshowet	Se HelpOnSlideShows
`[[Navigation(slides)]]`
	viser første/forrige/næste/sidste henvisninger	See HelpOnSlideShows
`[[AttachInfo]]`
	viser antal vedhæftede filer for den nuværende side	Se HelpOnActions/AttachFile
`[[AttachInfo(sidenavn)]]`
	viser antal vedhæftede filer for en side	Se HelpOnActions/AttachFile
`[[AttachList]]`
	viser en liste over vedhæftede filer for den nuværende side	Se HelpOnActions/AttachFile
`[[AttachList(sidenavn)]]`
	viser en liste over vedhæftede filer for en side	Se HelpOnActions/AttachFile

1.3. Systeminformation

Makro	Beskrivelse	Eskempel
`[[InterWiki]]`
	en liste over alle kendte InterWiki navne	InterWikiDansk
`[[SystemInfo]]`
	info om wiki'en, python-oversætteren og værtssystemet	SystemInfo
`[[PageCount(exists)]]`
	nuværende sideoptælling. Hvis `exists` tilføjes som et argument, vises kun sider som eksisterer.	26472 sider
`[[PageSize]]`
	viser en liste over størrelse af alle sider	Se SideStørrelse
`[[StatsChart(type)]]`
	viser statistiske diagrammer (nuværende definerede typer: hitcounts, pagesize, useragents)	Se HændelseStatistik og undersider
`[[SystemAdmin]]`
	Information for systemadministratorer	Kræver administrationsrettigheder.

1.4. 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.	See HelpOnMacros/ImageLink
`[[Icon(piktogram)]]`
	vis systempiktogrammer	See HelpOnNavigation
`[[UserPreferences]]`
	viser en brugerprofil-dialog	Se BrugerProfil
`[[UserPreferences(createonly)]]`
	viser brugeroprettelsesdialog
`[[BR]]`
	indsætter et linjeskift	1. linje 2. 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: Set your pages language with `#language en` processing instruction. See also HelpOnLanguages.
`[[Include(HelloWorld[,"heading"[,level]])]]`
	inkluderer indhold fra en anden side	for detailer se HelpOnMacros/Include
`[[FootNote(tekst)]]`
	Tilføjer en fodnote¹, 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-10-23
`[[DateTime(tidsstempel)]]`
	viser et tidsstempel² ifølge brugerprofil	2024-10-23 11:12: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	Se http://twistedmatrix.com/wiki/python/TeudProject
`[[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.³
`[[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:
`[[MonthCalendar(,,12)]]`
	Viser en kalender og opretter henvisninger til hver dag som undersider	Se HelpOnMacros/MonthCalendar

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)

1.5. 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:

   1 Dependencies = []
   2 
   3 def execute(macro, args):
   4     return macro.formatter.text("I fik disse argumenter fra en makro %s: %s" %
   5     (str(macro), args))

$/!\$ 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.