scriptin / maruji Goto Github PK

Alien technology for learning kanji

JavaScript 96.49% HTML 0.29% CSS 3.22%

maruji's Introduction

👋 Hello, my name is Dmitry

Website • LinkedIn • StackExchange • NPM • Tatoeba.org

I am a software developer, coding mostly webapps. Programming is both my job and hobby, but I am also interested in (natural) languages, cyber-security, astronomy, math, and art.

const scriptin = {
  name: "Dmitry Shpika", // [DMEE-tree SHPEE-kah]
  pronouns: ["he", "him"],
  education: [
    { specialty: "Software Engineering",
      type: "self-taught",
      experience: "12+ years" },
    { specialty: "IT Security",
      type: "degree",
      experience: "Occasional consulting and auditing" },
  ],
  hardSkills: {
    programming: [TypeScript, JavaScript, Kotlin, SQL, ShellScripts, Python],
    ui: [React, HTML, CSS, Tailwind, Bootstrap, MaterialUI, Figma],
    api: [GraphQL, REST, SOAP, RPC],
    buildTools: [Webpack, Vite, Gradle],
    graphics: [Canvas2D, Processing, P5js, SVG],
    testing: [TDD, BDD, Unit, E2E],
    ci: [Docker, GitHubActions, GitLabCI],
    other: [Parsing, WebScraping, XML],
    _outdated: [PHP, Java, jQuery, AngularJS], // In the past
  },
  softSkills: {
    teaching: "I like to explain complex topics in simple terms",
    learning: "Currently focusing on foreign languages",
    design: "Creating UIs using component libraries/frameworks, or from scratch",
    writing: `Technical and fiction.
              I've written 130+ answers on Stack Exchange,
              maybe 5-7 articles, dozens of readmes,
              countless Jira tickets,
              a few short novels and poems`,
  },
  hobbies: [Programming, Languages, Astronomy, Math, Art],
} satisfies SoftwareEngineer;

Check out my pinned repos 👇

maruji's People

Contributors

Stargazers

Watchers

maruji's Issues

Save progress and use it to build a reasonable queue of questions

Design the storage format suitable for localStorage
Handle updates when questions are being answered
Generate questions based on progress data, not rndomly

Backup progress via file export

Use Data URI scheme + download attribute or File API

Kanji components question type

Possible implementations

Fill in the missing component (or multiple components) in a kanji. In this case the kanji should be shown with a "hole": strokes which form a hidden component are missing, maybe only an outline is shown to mark a general area where missing strokes were. A user is then would have to choose a correct component from answer options below.
- Big open question: how to split kanji into components?
- Show hidden components as-is (missing strokes from a glyph), or as a stand-alone kanji? If shown as-is, it may be trivial to figure out the missing component just by inspecting the position, so that the chosen option fits into a blank spot. If shown stand-alone, strokes may have significantly different shapes, since we are dealing with partial kanji, variants, and various affine and non-affine transformations.
- If possible, take position into account, e.g. give answer options for the same component in different places.
Show a set of components, so that a user would have to reconstruct the whole kanji.
- There are strokes which do not participate in any components.
- There are simple kanji which only have one component.
- How to show these options? As-is or stand-alone? (Same as for previous implementation option)
Search a correct kanji by components, similar to jisho.org component search.
- Still, there is a problem of decomposition, because databases like KRADFILE are not adequate in terms of variants and shapes.
- In this case, users are not forced to memorize all components. Just one or two would be enough to find the correct kanji, since the set of kanji in the app is much more limited compared to jisho.org.

Problems with decompositions

Merged components. "克" decomposed as "古+兄", and "兄" has a part="2" attribute, hence considered "partial", when actually it is just a regular "儿" element.
Scattered parts of components. "回" consist of "囗+口", but "囗" is split into two parts, because first two of its' strokes are drawn before "口", and then the last stroke is drawn at the very end.

The only solid fix I imagine is to provide custom decompositions.

In-app instructions page / user manual

Write a user manual, explaining:

most efficient ways of using the application
limitations of used methods
available features

Make this a separate page inside the app, so that users wouldn't have to visit GitHub wiki.

About/attribution page

Create a page similar to http://jisho.org/about, with all copyright info.

Create a logo

Ideas:

style a "〇字" word, maybe just add okurigana
doge, since "Maru" is a common dog name

Module not found: Error: Cannot resolve module 'async_hooks'

Hey,

I tried to set up your app locally, but got an error.

Steps:

npm i --legacy-peer-deps
npm run start
Open http://localhost:8080/webpack-dev-server/ in Safari

Full error message:

ERROR in ./~/bluebird/js/release/promise.js
Module not found: Error: Cannot resolve module 'async_hooks' in /Users/gleb/git/maruji/node_modules/bluebird/js/release
 @ ./~/bluebird/js/release/promise.js 34:4-26

macOS 13.0.1
Node v16.19.0

Improve answer options: display semi-transparent ○/× symbols on buttons

Display circle (○) or cross (×) symbol on SVG buttons with answer options when they are clicked to provide additional indication of the result. Those symbols should fill the entire button and be semi-transparent, so that they do not obstruct kanji or get obstructed.

Currently it's only the green or red color which indicate if the answer was successful or not, which may be problematic for color-blind users.

Progress page

Button to reset progress
View progress: design appropriate D3 charts, tables, or whatever fits best

Deploy to GitHub Pages

Create a production build configuration
Deploy to GitHub Pages