Skip to content

Export a Fossil SCM wiki to Git preserving the revision history

License

Notifications You must be signed in to change notification settings

dbohdan/fossil-wiki-export

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

fossil-wiki-export

Export a Fossil SCM wiki to Git preserving (recreating) the revision history.

This program is the missing exporter for the wiki feature of Fossil SCM. It exports every Fossil wiki page to a file in a chosen subdirectory of a new or existing Git repository. Every wiki page revision becomes a Git commit. The commits are in correct chronological order (globally, not just by page). The appropriate author date is set for each commit through GIT_AUTHOR_DATE.

Known bugs and limitations

  • Each of the characters < > : " / \ | ? * is replaced with _ in the filename. This means that the pages Foo: Bar and Foo? Bar will be exported to the same file.

Requirements

  • Git 2.x. The program has been tested with version 2.25.1.
  • Fossil 2.14.2 or later. (Earlier versions may work but haven't been tested.)
  • Tcl 8.6 or later.

Usage

./fossil-wiki-export.tcl /path/to/repo.fossil /path/to/git-repo subdir-for-wiki-files

Environment variable settings

Besides the command line arguments, you can customize the behavior of FWE with environment variables.

  • FWE_AFTER (string, default 1900-01-01T00:00:00) — only export modifications after this timestamp (non-inclusive).
  • FWE_INIT (boolean, default true) — run git init in the target Git repository path.
  • FWE_TEMPLATE (string, default wiki($page): $action) — the commit message template. $page is replaced with the Fossil wiki page name (L in the card); $action, with "create", "update", or "delete".
  • FWE_VERBOSE (boolean, default false) — be verbose and print debug information.

License

MIT.

About

Export a Fossil SCM wiki to Git preserving the revision history

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Languages