hg site

Create and/or upload a static copy of a Mercurial repository.

You can get it via `hg clone http://draketo.de/proj/hgsite/`

The main goal is sharing code over servers which only offer
FTP access and statically served files, while providing the same
information as hg serve and full solutions like bitbucket and
gitorious (naturally without the interactivity).

Thanks to the static http support of Mercurial, the clone and browse
URLs are the same, so you can look at the site with your webbrowser or
clone the repository with Mercurial using the same URL.

On upload, only changed files are uploaded, based on the time they
were last modified, so uploads can be reasonably fast.

Install:

* Clone this repo.
  hg clone http://draketo.de/proj/hgsite/
* add this to the [extensions] section in your ~/.hgrc
  site = path/to/staticsite.py
  if you have no [extensions] section, add it.

Usage:

$ hg push [-f] --sitename "sitename" ftps://user:password@ftp.host.tld/path/to/dir
→ that’s how this site gets created. 
  With -f it is reuploaded completely, 
  otherwise only the changes get uploaded.
  defining the ftp://… or ftps://… in [paths] in .hg/hgrc works.

If you want to make this easier, add an alias to your .hg/hgrc:

    [paths]
    ftp = ftps://user:password@ftp.host.tld/path/to/dir
    [alias]
    pushsite = push --sitename "sitename" ftp

Then just use `hg pushsite` to upload.

To upload the site when you push it anywhere, you can use a hook in .hg/hgrc. This is what I use: 

    [hooks]
    post-push = hg site -n site -u user:password@ftp.host.tld/path/to/dir


$ hg site --help
hg site [options] [folder]

Create a static copy of the repository and/or upload it to an FTP server.

use "hg help -e site" to show help for the site extension

options:

 -n --name VALUE         the repo name. Default: folder or last segment of the
                         repo-path.
 -u --upload VALUE       upload the repo to the given ftp host. Format:
                         user:password@host/path/to/dir
 -f --force              force recreating all commit files. Slow.
 -s --screenstyle VALUE  use a custom stylesheet for display on screen
 -p --printstyle VALUE   use a custom stylesheet for printing
    --mq                 operate on patch repository

use "hg -v help site" to show global options


Copyright: Copyright 2012 till 2014 Arne Babenhauserheide, Licensed under GPLv2 or later.


Related: git2html → http://hssl.cs.jhu.edu/~neal/git2html/