You can the apertium-init tool to create ("bootstrap") a directory for quick development of a transducer.
If needed, download apertium-init and install it:
cd ~/ling073; git clone https://github.com/apertium/apertium-init; cd apertium-init; PREFIX=$HOME make install
Create a language module
Create an hfst-based apertium language module (in your
~/ling073 directory), replacing
xyz with the ISO code of your language in all occurrences:
apertium-init -a hfst xyz
Rename the module
ling073-xyz if you want (so that it matches what will be in github later, and any further instructions):
mv apertium-xyz ling073-xyz
- If get an error about SVN and the directory not being a working copy, then you have an old version of apertium-init.
- If something goes wrong (e.g., you make a typo), delete any directories/files that were created and try the step again.
Push to github
If this is a language pair you would like to push to github, do the following ideally before modifying any files or compiling the module:
- Create an empty (no files) repository named
- Make sure the repository really was created correctly by running
git log. You should see a single commit named "initial commit".
- Set the github repository you created as the remote origin:
git remote add origin email@example.com:username/ling073-xyz.git(replacing "username" and "xyz" below as appropriate)
- Push the bootstrapped module to origin:
git push --set-upstream origin master
- After this you should be able to see the same files from the github web interface and in the directory. You should also be able to commit, push, pull, etc. all normally.