X-Git-Url: http://repo.macrolet.net/gitweb/?a=blobdiff_plain;f=README.md;h=10756aadc7956fa9a1f3106c1422d18f54af6c82;hb=0daba3ec4ce446b8bea91b785fbf0f9d80c06cdc;hp=cad778fe5282e409b6cf96c67d9f13c154effa3e;hpb=f7ada8e8997481733847a14aa1df9a08ef20666d;p=crypto-install.git diff --git a/README.md b/README.md index cad778f..10756aa 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -crypto-install.py +crypto-install # USAGE @@ -14,11 +14,17 @@ it is always safe to do. - `--no-gpg` disables the GnuPG key generation and related setup routines - `--no-ssh` does the same for the OpenSSH setup -- `--gpg-home` sets the directory for the GnuPG files -- `--ssh-home` does the same for OpenSSH files +- `--gpg-home` sets the directory for the GnuPG files (defaults to the + value of `GNUPGHOME` or `~/.gnupg`) +- `--ssh-home` does the same for OpenSSH files (defaults to `~/.ssh`) There is also `-h/--help` and `-v/--version` as expected. +# ENVIRONMENT + +- `FULLNAME`, `EMAIL`, `USER` are used to pre-fill the corresponding + fields + # INSTALLATION Until I set up a better routine: @@ -33,3 +39,45 @@ Until I set up a better routine: Simply copy the built file into your path and possibly ensure execution permissions. + +# DEVELOPMENT + +There is a `Makefile` available to run common commands, e.g.: + + make # checks PEP8, runs tests, builds final file + make run # run the built program + make clean # remove build folder + +If you have [`git-hooks`](https://github.com/icefox/git-hooks) +installed, then the two hooks in `git_hooks` will run the tests and +check for PEP8 compatibility before committing as well. Run +`git hooks --install` in the checked out folder to register the hooks +initially. + +# LOCALISATION + +Currently working simultaneously on the English and German version. +Patches welcome. + +To run with a different language set, use: + + TEXTDOMAINDIR=locale LANGUAGE=de_DE ./crypto-install + +(I would really like to if that environment variable is okay to use +here!) + +**TODO**: If the application is installed, you should only have to set +the `LANGUAGE` environment variable instead, as the default locale +directory will be set during the installation (to +`prefix/share/locale` probably). + +To start off with a new translation, use: + + cd po + msginit -l en_US # or whatever language code + +You'll have to confirm, or edit the email address and author. +Afterwards, edit the new `.po` file as usual. + +Please read the `gettext` documentation (`info gettext`) for more +details.