{"id":20792662,"url":"https://github.com/futurulus/wiinaq","last_synced_at":"2025-12-25T08:26:50.221Z","repository":{"id":46857165,"uuid":"77114857","full_name":"futurulus/wiinaq","owner":"futurulus","description":"A Kodiak Alutiiq dictionary web application with automatically generated ending tables and souped-up search capabilities","archived":false,"fork":false,"pushed_at":"2023-04-21T22:37:35.000Z","size":554,"stargazers_count":2,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-01-18T11:11:54.241Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.wiinaq.org/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/futurulus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-12-22T05:26:58.000Z","updated_at":"2023-01-18T19:28:26.000Z","dependencies_parsed_at":"2024-01-07T18:03:33.030Z","dependency_job_id":"9352c019-1b5b-442e-9752-97a96c645255","html_url":"https://github.com/futurulus/wiinaq","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futurulus%2Fwiinaq","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futurulus%2Fwiinaq/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futurulus%2Fwiinaq/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futurulus%2Fwiinaq/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/futurulus","download_url":"https://codeload.github.com/futurulus/wiinaq/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243136026,"owners_count":20241990,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-17T15:53:13.055Z","updated_at":"2025-12-25T08:26:50.185Z","avatar_url":"https://github.com/futurulus.png","language":"Python","readme":"Overview\n========\n\nWord Wiinaq is a [Kodiak Alutiiq](http://www.alutiiqlanguage.org/) dictionary\nweb application with automatically generated ending tables and souped-up search\ncapabilities.\n\nIt is written in Python using Django.\n\nInstallation\n============\n\nDownloading and running locally\n-------------------------------\n\nIf you haven't already, you'll want to start by installing [Python\n2.7](https://www.python.org/downloads/) and\n[pip](https://pypi.python.org/pypi/pip).  Then install Django:\n\n    pip install django django-nose\n\nFind a nice spot for the repo and clone it:\n\n    git clone https://github.com/futurulus/wiinaq.git\n    cd wiinaq\n\nSet up the database:\n\n    ./manage.py migrate\n    ./manage.py loaddata sources words_free\n\nFinally, start the server:\n\n    ./server\n\nOnce you do this, your browser should be able to load the site locally at\nhttp://localhost:8000/.\n\nIf you'd like to take a look at how the admin interface works, make yourself a\nsuperuser account:\n\n    ./manage.py createsuperuser\n\nThen make sure the server is running, point your browser to\nhttp://localhost:8000/admin/, and enter the username and password you created\nin the previous command.\n\nRunning on Heroku\n-----------------\n\nWord Wiinaq is configured to run out of the box on Heroku. You'll\nneed to create an account at http://heroku.com/, initialize a Python app,\nand install the [Heroku CLI](https://devcenter.heroku.com/articles/heroku-command-line).\nThen issue these commands from your git repository:\n\n    heroku login\n    heroku git:remote -a \u003capp-name\u003e\n    heroku config:set ON_HEROKU=true \\\n        DJANGO_ALLOWED_HOSTS=\u003capp-name\u003e.herokuapp.com \\\n        DJANGO_SECRET_KEY=$(./secret_key)\n    git push heroku master\n\nThe environment variable `ON_HEROKU` changes a few things to make the app play\nwell with Heroku. The other two are security settings.\nA link to connect to the running website will show up near the end of the output\nfrom `git push`. However, the website won't quite work yet\u0026mdash;first\nyou need to run the same commands as above but on the Heroku box:\n\n    heroku run ./manage.py migrate\n    heroku run ./manage.py loaddata sources words_free\n    heroku run ./manage.py createsuperuser\n\nFinally, start up a dyno for hosting the app:\n\n    heroku ps:scale web=1\n\nIf you have additional dictionary files to load, you'll need to start a shell on\nHeroku and pull them in from some other Internet-accessible location, since Heroku\ndisallows incoming scp connections:\n\n    heroku run bash\n    $ scp some_online_location:new_words.csv dict_sources/\n    $ ./reload_data\n\nSetting up Dropbox backup\n-------------------------\n\nIf you only want to back up the database from your local installation, you can\nperiodically run\n\n    ./backup\n\nThe first time you run the script, you'll be prompted to set up your\ninformation on the Dropbox Apps website.\n\nTo configure this as a recurring job in Heroku, run the setup script (from your\nlocal installation):\n\n    ./heroku_setup_dropbox\n\nThen create a [Scheduler task](https://devcenter.heroku.com/articles/scheduler)\nto run `./backup` every so often.\n\nBulk editing/adding\n===================\n\nThe admin interface allows you to easily edit individual entries, but for\nadding or changing large numbers of entries in bulk, it can be inconvenient.\nYou can look through and edit a CSV dump of the database by running\n\n    ./export_csv \u003e data_dump.csv\n\n`data_dump.csv` can be called anything you'd like, and placed anywhere. The\ncolumns correpond to fields shown in the `Chunk` admin interface (the exact\norder is listed in `dictionary/json_to_csv.py`).\n\nOnce you've made your edits, replace the contents of the database with the new\nversion:\n\n    ./import_csv data_dump.csv\n\nYou'll be prompted to confirm this potentially destructive operation. The\nscript will automatically back up the database to a file in\n`dictionary/fixtures` first in case something goes wrong.\n\nLicense\n=======\n\nSee the file `LICENSE` for the full text of the GNU General Public License.\n\nCopyright (C) 2015-2016 William Monroe\n\nThis program is free software: you can redistribute it and/or modify it under\nthe terms of the GNU General Public License as published by the Free Software\nFoundation, either version 3 of the License, or (at your option) any later\nversion.\n\nThis program is distributed in the hope that it will be useful, but WITHOUT ANY\nWARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A\nPARTICULAR PURPOSE.  See the GNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License along with\nthis program.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n","funding_links":[],"categories":["Alutiiq"],"sub_categories":["Utilities"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuturulus%2Fwiinaq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffuturulus%2Fwiinaq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuturulus%2Fwiinaq/lists"}