https://github.com/andalugeeks/andaluh-electron
Electron application spanish-andaluz transcriptor
https://github.com/andalugeeks/andaluh-electron
andalucia andaluh andalusian andaluz electron epa hacktoberfest i18n language react spelling transcriptor translator transliterator
Last synced: 5 months ago
JSON representation
Electron application spanish-andaluz transcriptor
- Host: GitHub
- URL: https://github.com/andalugeeks/andaluh-electron
- Owner: andalugeeks
- License: lgpl-3.0
- Created: 2020-09-21T19:57:05.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-05-28T07:58:12.000Z (about 5 years ago)
- Last Synced: 2024-04-28T04:43:12.665Z (about 2 years ago)
- Topics: andalucia, andaluh, andalusian, andaluz, electron, epa, hacktoberfest, i18n, language, react, spelling, transcriptor, translator, transliterator
- Language: JavaScript
- Homepage: http://andaluh.es/transcriptor-andaluh
- Size: 300 KB
- Stars: 3
- Watchers: 4
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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.