leekangsan / kanji-koohii

A web application to help Japanese language learners remember the kanji.

Home Page:https://kanji.koohii.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Kanji Koohii

Kanji Koohii is a web application designed to help Japanese language learners remember the kanji. http://kanji.koohii.com
Join the chat at https://gitter.im/kanji-koohii/Lobby


The mobile view



The desktop view

Feedback & Suggestions

Create an "issue" in the Issues tab. New issue.

Contributing

Let's talk on on Gitter! It'll save you time getting into the codebase. If you'd like to help on existing issues have a look at Milestones. I use milestones to group issues in categories such as UX Improvements, Front End Performance, etc.

Project History

Keep in mind I started the website all the way back in the August 2005. The website was pretty much one-php-script-per-page for the first year. It was known then as "Reviewing the Kanji". A year or so later, I created a very barebones MVC inspired by Symfony 1. Thankfully because I followed the same API and conventions than Symfony a few years later I was able to refactor to the actual Symfony 1 package.

Documentation

The documentation is manually updated and intended to work as a cheatsheet for common MVC & custom APIs. It has been very helpful for me over the years for that purpose. For more fine-grained documentation refer to the phpdoc comments. For Koohii classes I tend to keep a summary of the methods at the top of the file.

Requirements

Development requires a typical LAMP setup (Apache/MySQL/Php) with a shell (ie. Linux, OS X or a VM on Windows).

  • Php 7.0+ with xml, mbstring, curl.
  • OPTIONAL: JRE (Java Runtime Env.) for Closure compiler and yuicompressor (.jar).

Development setup

  • First Time Setup for setting up the repository and database
  • Build for basic info about dev/test environments

Project Roadmap

  • Refactoring legacy php templating to Vuejs client-side components
  • Vocabulary features : "favorite" example words in Study pages, create a vocab deck and review with SRS
  • Improve Study pages : better moderation & voting system, stroke order animations, better search
  • Improve the API for third party clients like Kanji Ryokucha

For more details see Open Source on the wiki.

LICENSE

License: AGPL v3

The source code is licensed as AGPLv3 (see the LICENSE file), with exception of the following third party licenses.

Acknowledgments

This list is not exhaustive and may be updated from time to time. The main purpose is to give an overview of things Kanji Koohii is built on.

Copyright Notices

Choice of license. The GNU AFFERO GENERAL PUBLIC LICENSE v3 is chosen to encourage cooperation, particularly in the case of network distributed software. Specifically: "public use of a modified version, on a publicly accessible server, gives the public access to the source code of the modified version."

Original assets. The website design and identity as "Kanji Koohii", as well as original artwork (such as the logo) are Copyright 2017 Fabrice Denis and intended for use exclusively at the kanji.koohii.com domain.

RTK Index and Keywords: The AGPL license does not cover permission granted explicitly to Fabrice Denis and for use on Kanji Koohii (previously "Reviewing the Kanji") by James W. Heisig, author of "Remembering the Kanji", to use the RTK index and keywords. The database provided with the repository includes RTK index and keywords for development purposes only, and the permission to use them does not extend to derived works based on this public repository and its data files.

Font Awesome 5 Pro: as a backer of FontAwesome 5 Pro, I may use FA 5 Pro resources in the future. The license is for my own use on my projects including Kanji Koohii, and does not extend to any derivative uses of this software (see FAQ).

About

A web application to help Japanese language learners remember the kanji.

https://kanji.koohii.com

License:GNU Affero General Public License v3.0


Languages

Language:PHP 65.4%Language:JavaScript 20.4%Language:CSS 6.5%Language:Vue 4.9%Language:Perl 1.4%Language:HTML 0.7%Language:Shell 0.6%Language:Hack 0.1%