ikiwiki-makerepo(1)

πŸ’– ikiwiki-makerepo β€” the group-chat version πŸ’–

okay bestie so you've got a wiki srcdir just... sitting there, un-versioned, living its raw uncommitted life? not on my watch. this is ikiwiki-makerepo(1), from the General Commands Manual, and it's about to give your directory main character energy in revision control. πŸŽ€


✨ NAME ✨

ikiwiki-makerepo β€” check an ikiwiki srcdir into revision control


🌸 SYNOPSIS 🌸

ikiwiki-makerepo git|svn|monotone|darcs|cvs srcdir repo

ikiwiki-makerepo bzr|mercurial srcdir

look at that second form. just two args. bzr and mercurial said "we don't need a repo argument, we contain multitudes" and honestly? iconic. πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

ikiwiki-makerepo takes an existing srcdir directory β€” the one holding the sources for an ikiwiki wiki β€” and injects it into revision control. like, straight in. no cap. 🫢

not me reminding you: this is rarely run directly. the chill move is using ikiwiki --setup /etc/ikiwiki/wiki.setup to set up a wiki instead. iykyk.

now the tea per version-control system, because they do NOT all behave the same and the way that they differ is so important:

  • for git, the repo is created as a bare git repository, and the srcdir is made into a clone of it. (monotone and darcs are similar.)
  • for svn and cvs, the repo is the centralized repository, and the srcdir is a checkout of it.
  • for mercurial and bzr, the srcdir is the only repository set up. that's it. that's the whole thing.
  • for darcs, the master repo's apply hook will be preconfigured to call a ikiwiki wrapper. fancy. ⭐
🌈 heads up bestie: for monotone, you are assumed to already have run mtn genkey to generate a key. do that first or you're gonna have a bad time. πŸ’€

πŸ’œ EXAMPLE πŸ’œ

ikiwiki-makerepo git /srv/web/wiki /srv/git/wiki.git/

this creates a bare repository /srv/git/wiki.git/, and sets up /srv/web/wiki to be a clone of it, committing any files that already exist in that directory. ✨ ate and left no crumbs ✨


πŸ‘‘ AUTHOR πŸ‘‘

Joey Hess <joey@ikiwiki.info> β€” the blueprint, the blueprint, fr fr. πŸ’–


and that's the whole page, bestie πŸŽ€ this was ikiwiki-makerepo(1) out of the General Commands Manual β€” go forth, commit your srcdir, and slay. πŸ¦‹πŸ’