summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2023-03-02 20:01:10 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2023-03-02 20:01:10 +0000
commitda875fcb62c801b8d19b3d4d984ad963574fb356 (patch)
tree3d85503747c56c2a387b291524442946f4bebb73 /README.md
parentInitial commit. (diff)
downloadpysilfont-da875fcb62c801b8d19b3d4d984ad963574fb356.tar.xz
pysilfont-da875fcb62c801b8d19b3d4d984ad963574fb356.zip
Adding upstream version 1.6.0.upstream/1.6.0upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'README.md')
-rw-r--r--README.md40
1 files changed, 40 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..01d6aea
--- /dev/null
+++ b/README.md
@@ -0,0 +1,40 @@
+# Pysilfont - a collection of utilities for font development
+
+Pysilfont is a collection of tools to support font development, with an emphasis on UFO-based workflows. With some limitations, all UFO scripts in Pysilfont should work with UFO2 or UFO3 source files - and can convert from one format to the other.
+
+In addition, all scripts will output UFOs in a normalized form, designed to work with source control systems.
+
+Please read the main [documentation](docs/docs.md) in the docs folder for more details. Within there is a list of [scripts](docs/scripts.md).
+
+## Installation
+
+Pysilfont requires Python 3.6+ and pip3. Some scripts also need other libraries.
+
+### Simple install
+To just install the main scripts without cloning the github repository run:
+```
+sudo python3 -m pip install git+https://github.com/silnrsi/pysilfont
+```
+
+This will allow you to run the scripts listed in [scripts.md](docs/scripts.md), but won’t give access
+to the example scripts or give you the code locally to look at.
+
+### Full install
+
+First clone this repository or download the files from this [github URL](https://github.com/silnrsi/pysilfont).
+Then navigate to the resulting pysilfont directory and run:
+```
+sudo python3 -m pip install .
+```
+in the pysilfont directory
+
+### Uninstalling pysilfont
+
+pip3 can be used to uninstall pysilfont:
+```
+sudo pip3 uninstall pysilfont
+```
+
+## Contributing to the project
+
+Pysilfont is developed and maintained by SIL International’s [Writing Systems Technology team ](https://software.sil.org/wstech/), though contributions from anyone are welcome. Pysilfont is copyright (c) 2014-2022 [SIL International](http://www.sil.org) and licensed under the [MIT license](http://en.wikipedia.org/wiki/MIT_License). The project is hosted at [https://github.com/silnrsi/pysilfont](https://github.com/silnrsi/pysilfont).