/Torjoman

Torjoman aims to make translating more accessible to general users, by translating inside the users favourite Platforms

Primary LanguagePythonGNU Affero General Public License v3.0AGPL-3.0

Torjoman | تُرجمان

Torjoman aims to make translating more accessible to general users, by translating inside the users favourite Platforms, be it chat or a website or any other platform. So translations can be crowd sourced from even more people, which will result in more recognizable translations for normal users.

it's designed to be modular, so anyone can create a plug-in to support any new platform, using the Torjoman Plug-in API.

The project is currently in the planing phase, and you can find the documentation and the plan here(in Arabic only currently): https://torjoman.aosus.dev

Flowchart

https://torjoman.aosus.dev/project-plan/#_3

How to run

  1. Install dependencies
    • Using pipenv pipenv install
    • Using pip pip install -r requirements.txt
  2. Create .env file Create a .env file in project and fill it with the following data 
    SECRET_KEY=
HOST=
GITHUB_ACCOUNT_TOKEN
GITHUB_WEBHOOK_KEY=
DATABASE_NAME=
DATABASE_USER=
DATABASE_PASSWORD=
DATABASE_HOST=
DATABASE_PORT=5432
JSON_REPO=GtihubUser/REPO
JSON_FILE=PathToJsonFileInYourRepo
    json file format example can be found in json-example.json
  3. Run python project/prepare-project.py
  4. Create superuser account, Run python manage.py createsuperuser
  5. Run python manage.py migrate
  6. Static Files (css, js, images)
    1. Run python manage.py collectstatic
    2. serve static folder, see here
  7. Run server. see Here
  8. Wait for the server to finish extracting data from the json file. It will print The first data extraction process has been completed when it finishes
  9. Set your github webhook payload url to https://your-domain.com/api/webhook/. Don't forget to set webhook key
  10. Add some platfroms endpoints to deal with from htStps://your-domain.com/admin

License

Torjoman is licensed under the AGPLv3

license