hg site: static repositories
============================

Get it via `hg clone http://draketo.de/proj/hgsite/`

With hg site you can say goodbye to vendor lock-in.


Description
-----------

The goal of hg site is sharing code over commodity 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, but you can always
clone the repo to interact).

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.

[Mercurial]: http://mercurial.selenic.com "Fast and easy-to-use, free distributed version control system."

The fork detection allows tieing multiple platforms together: It
tracks repositories from any source for which Mercurial can calculate
incoming and outgoing changes. And since the bugtracking happens via
the b-extension, your bugtracking follows your code wherever you go.


Features
--------

- shows the history, branches, tags and bookmarks.
- shows bugs tracked via the [b-extension][].
- shows the readme.
- shows forks which are defined as paths in `.hg/hgrc` - from any source hg supports.
- uploads only  hanged files (based on the time they were last modified), so uploads can be reasonably fast.
- Supports FTP and FTPS. Use the latter if you can (just use URLs starting with `ftps://`).
- static site (no vulnerabilities, little dependencies, high performance).

[b-extension]: http://mercurial.selenic.com/wiki/bExtension "Distributed Bug Tracking: Get bugs resolved, not organized"


Installation
------------

* 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


Basic Options
-------------

    $ 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
    

Customization
-------------

To change the appearance of your site, create it once and then copy style.css and print.css from `._site/`. Adapt them and use -s path/to/your/screen.css and  -p path/to/your/print.css to use your adaptions.



Notes
-----

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

Related: [git2html][] 

[git2html]: http://hssl.cs.jhu.edu/~neal/git2html/ "A static repository generator for git"