# Andaluh-electron Transliterate español (spanish) spelling to andaluz electron app transcriptor.  ## Table of Contents - [Description](#description) - [Run](#run) - [Build](#build) - [Installation](#installation) - [deb](#deb) - [rpm](#rpm) - [Snap](#snap) - [appImage](#appimage) - [Support](#support) - [Contributing](#contributing) ## Description The **Andalusian varieties of [Spanish]** (Spanish: *andaluz*; Andalusian) are spoken in Andalusia, Ceuta, Melilla, and Gibraltar. They include perhaps the most distinct of the southern variants of peninsular Spanish, differing in many respects from northern varieties, and also from Standard Spanish. Further info: https://en.wikipedia.org/wiki/Andalusian_Spanish. This app uses the [Andaluh-js](https://github.com/andalugeeks/andaluh-js). As there's no official or standard andaluz spelling, andaluh-js is adopting the **EPA proposal (Er Prinzipito Andaluh)**. Further info: https://andaluhepa.wordpress.com. Other andaluz spelling proposals are planned to be added as well. ## Run Andaluh-electron requires `nodejs` >= 12.x.x to run. Running is as simple as installing dependencies with `npm install` and then running the scripts `npm run-script start:react` and `npm run-script start:electron` as follows: ``` $ npm install > core-js@2.6.11 postinstall ~/andaluh-electron/node_modules/babel-runtime/node_modules/core-js > node -e "try{require('./postinstall')}catch(e){}" Thank you for using core-js ( https://github.com/zloirock/core-js ) for polyfilling JavaScript standard library! The project needs your help! Please consider supporting of core-js on Open Collective or Patreon: > https://opencollective.com/core-js > https://www.patreon.com/zloirock Also, the author of core-js ( https://github.com/zloirock ) is looking for a good job -) > core-js@3.6.5 postinstall ~/andaluh-electron/node_modules/core-js > node -e "try{require('./postinstall')}catch(e){}" > core-js-pure@3.6.5 postinstall ~/andaluh-electron/node_modules/core-js-pure > node -e "try{require('./postinstall')}catch(e){}" > electron@10.1.2 postinstall ~/andaluh-electron/node_modules/electron > node install.js > nodemon@2.0.4 postinstall ~/andaluh-electron/node_modules/nodemon > node bin/postinstall || exit 0 npm WARN andaluh-electron@1.0.0 No repository field. npm WARN andaluh-electron@1.0.0 license should be a valid SPDX license expression npm WARN optional SKIPPING OPTIONAL DEPENDENCY: fsevents@1.2.13 (node_modules/webpack-dev-server/node_modules/fsevents): npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: Unsupported platform for fsevents@1.2.13: wanted {"os":"darwin","arch":"any"} (current: {"os":"linux","arch":"x64"}) npm WARN optional SKIPPING OPTIONAL DEPENDENCY: fsevents@1.2.13 (node_modules/watchpack-chokidar2/node_modules/fsevents): npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: Unsupported platform for fsevents@1.2.13: wanted {"os":"darwin","arch":"any"} (current: {"os":"linux","arch":"x64"}) npm WARN optional SKIPPING OPTIONAL DEPENDENCY: fsevents@2.1.2 (node_modules/react-scripts/node_modules/fsevents): npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: Unsupported platform for fsevents@2.1.2: wanted {"os":"darwin","arch":"any"} (current: {"os":"linux","arch":"x64"}) npm WARN optional SKIPPING OPTIONAL DEPENDENCY: fsevents@1.2.13 (node_modules/jest-haste-map/node_modules/fsevents): npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: Unsupported platform for fsevents@1.2.13: wanted {"os":"darwin","arch":"any"} (current: {"os":"linux","arch":"x64"}) npm WARN optional SKIPPING OPTIONAL DEPENDENCY: fsevents@2.1.3 (node_modules/fsevents): npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: Unsupported platform for fsevents@2.1.3: wanted {"os":"darwin","arch":"any"} (current: {"os":"linux","arch":"x64"}) added 2114 packages from 853 contributors and audited 2119 packages in 40.051s 87 packages are looking for funding run `npm fund` for details found 0 vulnerabilities $ npm run-script start:react & npm run-script start:electron ``` *Note*: You may have to run the two scripts of the last command above on different terminals. ## Build Thanks to `electron-builder` several packages (`deb`, `rpm`, `snap (unsigned)`, `appImage`) are build with a single command: `npm run-script build`. You need to have the following dependencies installed in order to generate the packages: `dpkg`, `rpm`, `snap`. ``` $ npm run-script build > andaluh-electron@1.0.0 prebuild ~/andaluh-electron > node tasks/prebuild.js Removing ~/andaluh-electron/build Removing ~/andaluh-electron/dist > andaluh-electron@1.0.0 build ~/andaluh-electron > npm run build:react && npm run build:electron > andaluh-electron@1.0.0 build:react ~/andaluh-electron > react-scripts build Creating an optimized production build... Compiled successfully. File sizes after gzip: 134.07 KB build/static/js/2.8b009245.chunk.js 12.68 KB build/static/js/main.7e1f83c8.chunk.js 780 B build/static/js/runtime-main.edf38bd2.js 159 B build/static/css/main.8f082792.chunk.css The project was built assuming it is hosted at ./. You can control this with the homepage field in your package.json. The build folder is ready to be deployed. Find out more about deployment here: bit.ly/CRA-deploy > andaluh-electron@1.0.0 build:electron ~/andaluh-electron > electron-builder • electron-builder version=22.8.1 os=4.15.0-118-generic • loaded configuration file=package.json ("build" field) • writing effective config file=dist/builder-effective-config.yaml • packaging platform=linux arch=x64 electron=10.1.2 appOutDir=dist/linux-unpacked • building target=snap arch=x64 file=dist/andaluh-transcriptor-1.0.0-amd64.snap • building target=AppImage arch=x64 file=dist/andaluh-transcriptor-1.0.0-x86_64.AppImage • building target=deb arch=x64 file=dist/andaluh-transcriptor-1.0.0-amd64.deb • building target=rpm arch=x64 file=dist/andaluh-transcriptor-1.0.0-x86_64.rpm ``` ## Installation ### DEB For `debian` or `ubuntu` linux systems, run the following command after package build: ``` $ sudo dpkg -i dist/andaluh-transcriptor-1.0.0-amd64.deb ``` ### RPM For `redhat` or `fedora` linux systems, run the following command after package build: ``` $ sudo rpm i dist/andaluh-transcriptor-1.0.0-x86_64.rpm ``` ### Snap A cross linux distro `snap` installation package is also available. It is distributed unsigned (so far), so please use the followign command to install the snap package after build: ``` $ sudo snap install --dangerous /dist/andaluh-transcriptor-1.0.0-amd64.snap ``` ### appImage A cross linux distro `appImage` executable is also available. You can just execute it as-is without installing ``` $ ./dist/andaluh-transcriptor-1.0.0-x86_64.AppImage ``` ## Support Please [open an issue](https://github.com/andalugeeks/andaluh-electron/issues/new) for support. ## Contributing Please contribute using [Github Flow](https://guides.github.com/introduction/flow/). Create a branch, add commits, and open a pull request.