Repository files navigation

cesko-digital/movapp/cesko-digital/movapp-apple

Source is under MIT license. Texts, images and audio files areunderCC BY-NC 4.0 license.

This repository is for opening our data files to #opensource community. Our applications copy the data files as needed.

Our data is created and updated inAirtable (PhrasesandCategories, login required).

We are providing translations from Ukraine to given languages

What to add new language? Contact us atpryvit@movapp.cz

We have developed some tools to help us automate boring stuff using nodejs scripts written in Typescript.

At first install all dependencies.

npm install

• We need to convert out Typescript code to nodejs Javascript usingts-node
  • npm run build Build once
  • npm run watch Build on changes
• We need to ensure same style of code usingnpm run lint

• AirTable npm docs
• AirTable API - login required
• Process diagram
• Azure SDK

• You can set environment variables by creating a.env file according to.env.example.
• You can also use run configurations (PHPStorm or any other IDE). Set the environment in GUI and do not store the file to the repository.
• Alternatively, you can set environment variables using the command line:

export AIRTABLE_API_KEY=YOUR_SECRET_API_KEYexport AZURE_SUBSCRIPTION_KEY=KEYexport AZURE_REGION=REGION#export DEBUG=true

For showing debug logs use DEBUG=true environment (in file or by passing to cli)

npm run build:dictionarynpm run build:alphabet

1. Go toActions / Build from AirTable
2. PresRun workflow on the right side above "workflow runs table" button and selectmain branch andRun workflow

• If you change the file structure (breaking changes), you must release a new version ofteam.json,example:team.vX.json.
• If you added new property inteam.json you have to adjust team.schema.json.
• If the changes contains only new additions (new name, new section) then we do not need to update the clients so no need of new version

The movapp website and apps have a separatevocabulary section for children (and amemory game). Phrases for these sections are stored the same way as any other phrase category. Use therecSHyEn6N0hAqUBp category id to retrieve the Kid's section phrases.

The idea is to manage stories in central repository that will be automatically distributed to client apps without any dev cost (just reviewing the PR).

1. Create new folder indata/stories folder. The name of the folder is a URL slug of the story.
   1. In this folder add all story MP3s named by a language code:uk.mp3,cs.mp3,pl.mp3 and more.
   2. Generate themetadata.json file, you can usestories_transformer.rb for now, just open command line and typeruby stories_transformer.rb path_to_web_file and move the file to this folder and rename it tometadata.json
2. Add your story to thedata/stories/metadata.json
3. Add new folder intodata/images/apple ordata/images/android folder the name is the same as the URL slug of the story.
   1. For apple use @1, @2, and @3 images (you can useresizer)
   2. For Android you have to usewebp file.