Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ikiwiki-calendar(1)	    General Commands Manual	   ikiwiki-calendar(1)

NAME
       ikiwiki-calendar	- create calendar archive pages

SYNOPSIS
       ikiwiki-calendar	[-f] your.setup	[pagespec] [startyear [endyear]]

DESCRIPTION
       ikiwiki-calendar	 creates pages that use	the ikiwiki/directive/calendar
       directive, allowing the archives	to be browsed one  month  at  a	 time,
       with calendar-based navigation.

       You  must  specify the setup file for your wiki.	The pages will be cre-
       ated inside its srcdir, beneath the archivebase directory used  by  the
       calendar	plugin (default	"archives").

       To  control  which pages	are included on	the calendars, a ikiwiki/Page-
       Spec can	be specified. The default is all pages,	or the pages specified
       by the comments_pagespec	setting	in the config  file.  A	 pagespec  can
       also  be	 specified on the command line.	To limit it to only posts in a
       blog, use something like	"posts/* and !*/Discussion".

       It defaults to creating calendar	pages for the  current	year.  If  you
       specify	a  year, it will create	pages for that year.  Specify a	second
       year to create pages for	a span of years.

       Existing	pages will not be overwritten by this command by default.  Use
       the -f switch to	force it to overwrite any existing pages.

CRONTAB
       While this command only needs to	be run	once  a	 year  to  update  the
       archive	pages  for each	new year, you are recommended to set up	a cron
       job to run it daily, at midnight. Then it will also update  the	calen-
       dars to highlight the current day.

       An example crontab:

	0 0 * *	* ikiwiki-calendar ~/ikiwiki.setup 'posts/* and	!*/Discussion'

TEMPLATES
       This  command  uses  two	 templates  to	generate  the pages, calendar-
       month.tmpl and calendaryear.tmpl.

plugins/calendar setup option
       Most of the goals of this command can be	replaced by setting up	calen-
       dar_autocreate  setup  option (of plugin	plugins/calendar), and running
       ikiwiki --setup you.setup. The only thing that ikiwiki-calendar can  do
       and that	ikiwiki	cannot is forcing page generation (using -f switch).

AUTHOR
       Joey Hess <joey@ikiwiki.info>

							   ikiwiki-calendar(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ikiwiki-calendar&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help