+
Skip to content

andrianllmm/aklish

Repository files navigation

Aklish

A web app for crowdsourcing Aklanon-English translations

Preview

About

Aklish is a web app that crowdsources Aklanon-English translations. The platform lets users contribute translations with quality control (dictionaries and spellcheckers) and engagement (leaderboards and word games) strategies.

Features

  • Bidirectional input of translations
  • Browse and search
  • Voting system
  • Aklanon-English dictionary
  • Aklanon and English proofreader (spellchecker)
  • Points (reputation) system
  • Leaderboard system
  • Games
    • Wordle
    • Synonym-antonym match
  • Authentication

Technologies

  • Front-End: JS ES14, React 18, HTML 5, CSS 4, SASS 1, Bootstrap 5
  • Back-End: Python 3, Django 5
  • Database: MySQL
  • APIs: REST
  • Testing: PyTest
  • Deployment: Railway

Usage

  1. Register an account: since some features can only be accessed by authenticated users, sign up to create a new account or sign in if you already have one.
  2. Earn reputation: some features can only be accessed by earning enough reputation points.
  3. Participate: to earn reputation, submit translations, bookmark, vote, and more.
  4. Learn more: visit the help center for more information.

Dev Setup

  1. Clone the repo
    git clone https://github.com/andrianllmm/aklish.git
    cd aklish
  2. Create and activate a virtual environment
    python -m venv env
    source venv/bin/activate  # or `venv\Scripts\activate` for Windows
  3. Install the dependencies
    pip install -r requirements.txt
  4. Apply migrations
    python manage.py migrate
  5. Run the development server
    python manage.py runserver

Configuration

Create a .env file and configure the following variables:

  • DATABASE_URL: database connection URL
  • SECRET_KEY: Django secret key
  • DEBUG: set to True for development or False for production

Contributing

Contributions are welcome! To get started:

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a pull request

Issues

Found a bug or issue? Report it on the issues page.

About

A web app for crowdsourcing Aklanon-English translations

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published
点击 这是indexloc提供的php浏览器服务,不要输入任何密码和下载