README.md

   1 crypto-install
   2
   3 # USAGE
   4
   5 Run the script to install a baseline setup for both GnuPG and OpenSSH.
   6
   7 Existing files are detected and not touched in the process, so running
   8 it is always safe to do.
   9
  10 # OPTIONS
  11
  12 - `--no-gui` disables the GUI, which means text mode will be enabled for
  13   everything including the passphrase input
  14 - `--no-gpg` disables the GnuPG key generation and related setup
  15   routines
  16 - `--no-ssh` does the same for the OpenSSH setup
  17 - `--gpg-home` sets the directory for the GnuPG files (defaults to the
  18   value of `GNUPGHOME` or `~/.gnupg`)
  19 - `--ssh-home` does the same for OpenSSH files (defaults to `~/.ssh`)
  20
  21 There is also `-h/--help` and `-v/--version` as expected.
  22
  23 # ENVIRONMENT
  24
  25 - `FULLNAME`, `EMAIL`, `USER` are used to pre-fill the corresponding
  26   fields
  27
  28 # INSTALLATION
  29
  30 Until I set up a better routine:
  31
  32     git clone https://github.com/Ferada/crypto-install.git
  33     # or
  34     git clone git@github.com:Ferada/crypto-install.git
  35
  36     cd crypto-install
  37     python setup.py install
  38
  39 Using `--prefix` with `install` the path may be changed to just locally
  40 install it for e.g. the current user.
  41
  42 # DEVELOPMENT
  43
  44 There is a `Makefile` available to run common commands, e.g.:
  45
  46     make # checks PEP8, runs tests, builds final file
  47     make run # run the built program
  48     make clean # remove build folder
  49
  50 If you have [`git-hooks`](https://github.com/icefox/git-hooks)
  51 installed, then the two hooks in `git_hooks` will run the tests and
  52 check for PEP8 compatibility before committing as well.  Run
  53 `git hooks --install` in the checked out folder to register the hooks
  54 initially.
  55
  56 # LOCALISATION
  57
  58 Currently working simultaneously on the English and German version.
  59 Patches welcome.
  60
  61 To run with a different language set, use:
  62
  63     TEXTDOMAINDIR=locale LANGUAGE=de_DE ./crypto-install
  64
  65 (I would really like to if that environment variable is okay to use
  66 here!)
  67
  68 **TODO**: If the application is installed, you should only have to set
  69 the `LANGUAGE` environment variable instead, as the default locale
  70 directory will be set during the installation (to
  71 `prefix/share/locale` probably).
  72
  73 To start off with a new translation, use:
  74
  75     cd po
  76     msginit -l en_US # or whatever language code
  77
  78 You'll have to confirm, or edit the email address and author.
  79 Afterwards, edit the new `.po` file as usual.
  80
  81 Please read the `gettext` documentation (`info gettext`) for more
  82 details.