From 147e8b4afbc1d35dd5ad07cb6d2d0af0a33048c7 Mon Sep 17 00:00:00 2001 From: Senja Jarva Date: Mon, 9 Nov 2020 10:04:09 +0200 Subject: [PATCH 1/4] Add the possibility to translate all the rest of the texts in this app (title, subtitle, choose language, usage and output headings, link texts to Object Explorer and MDN docs), and add Finnish translations for these. Also add the texts to /locale/en/index.js because I think many translators will copy that, and then translate everything in it, without looking at other translations or the component code --- src/App.vue | 6 +++--- src/components/AppCode.vue | 2 +- src/components/LocaleSwitcher.vue | 4 ++-- src/components/methods/MethodBase.vue | 2 +- src/locale/en/index.js | 9 ++++++++- src/locale/fi/index.js | 7 +++++++ 6 files changed, 22 insertions(+), 8 deletions(-) diff --git a/src/App.vue b/src/App.vue index 15dcd80..e864fc3 100644 --- a/src/App.vue +++ b/src/App.vue @@ -4,12 +4,12 @@
-

JavaScript Array Explorer

-

Find the array method you need without digging through the docs

+

{{$t('title', 'JavaScript Array Explorer')}}

+

{{$t('subtitle', 'Find the array method you need without digging through the docs')}}

-

Usage

+

{{$t('usage', 'Usage')}}

diff --git a/src/components/AppCode.vue b/src/components/AppCode.vue index efae836..dd10fad 100644 --- a/src/components/AppCode.vue +++ b/src/components/AppCode.vue @@ -11,7 +11,7 @@

-

Output

+

{{$t('output', 'Output')}}

- Object Explorer + {{$t('linkToObjectExplorer', 'Object Explorer')}} -
Language: +
{{$t('chooseLanguage', 'Language')}}: diff --git a/src/components/methods/MethodBase.vue b/src/components/methods/MethodBase.vue index d1dc3bd..2eb9e24 100644 --- a/src/components/methods/MethodBase.vue +++ b/src/components/methods/MethodBase.vue @@ -2,7 +2,7 @@ diff --git a/src/locale/en/index.js b/src/locale/en/index.js index 466088b..2209123 100644 --- a/src/locale/en/index.js +++ b/src/locale/en/index.js @@ -19,6 +19,13 @@ export default { 'return a string', 'order an array', 'something else' - ] + ], + docsLink: 'See the docs', + usage: 'Usage', + output: 'Output', + title: 'JavaScript Array Explorer', + subtitle: 'Find the array method you need without digging through the docs', + chooseLanguage: 'Language', + linkToObjectExplorer: 'Link to Object Explorer', // other text can be added here } diff --git a/src/locale/fi/index.js b/src/locale/fi/index.js index 1b0eead..4616e9e 100644 --- a/src/locale/fi/index.js +++ b/src/locale/fi/index.js @@ -20,5 +20,12 @@ export default { 'järjestää taulukon', 'tehdä jotain muuta', ], + docsLink: 'Koko dokumentaatio', + usage: 'Koodi', + output: 'Tuloste', + title: 'JavaScriptin Taulukoiden pikaopas', + subtitle: 'Löydä tarvitsemasi taulukkometodi ilman turhauttavaa dokumentaation selaamista', + chooseLanguage: 'Valitse kieli', + linkToObjectExplorer: 'Linkki Olioiden pikaoppaaseen', // other text can be added here }; From bc78c2ccbead0c56964fd855eaaa92014cd868bf Mon Sep 17 00:00:00 2001 From: Minna Nurmiluoto <44906587+minna-xD@users.noreply.github.com> Date: Mon, 9 Nov 2020 21:29:18 +0200 Subject: [PATCH 2/4] small changes, just setting up my own branch --- src/locale/fi/index.js | 4 ++-- store/fi/index.js | 8 ++++---- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/src/locale/fi/index.js b/src/locale/fi/index.js index 4616e9e..15d22bd 100644 --- a/src/locale/fi/index.js +++ b/src/locale/fi/index.js @@ -1,7 +1,7 @@ export default { firstMethod: 'Minulla on taulukko, haluan', findMethod: 'Yritän löytää', - methodOptions: 'haluan', + methodOptions: 'Haluan', methodTypes: { add: 'lisätä', remove: 'poistaa', @@ -15,7 +15,7 @@ export default { 'lisätä alkioita tai muita taulukoita', 'poistaa alkioita', 'löytää alkioita', - 'iteroida alkioita', + 'käydä alkioita läpi', 'palauttaa merkkijonon', 'järjestää taulukon', 'tehdä jotain muuta', diff --git a/store/fi/index.js b/store/fi/index.js index 5fdc7f3..417f065 100644 --- a/store/fi/index.js +++ b/store/fi/index.js @@ -6,13 +6,13 @@ export default { name: 'splice', shortDesc: 'alkion tai alkioita taulukkoon', desc: 'Lisää ja/tai poistaa alkioita taulukosta.', - example: `arr.splice(2, 0, 'tacos');
+ example: `arr.splice(2, 0, 'tacoja');
console.log(arr);`, - output: `[5, 1, 'tacos', 8]`, + output: `[5, 1, 'tacoja', 8]`, }, { name: 'push', - shortDesc: 'alkiota taulukon loppuun', + shortDesc: 'alkioita taulukon loppuun', desc: 'Lisää yhden tai useamman alkion taulukon loppuun ja palauttaa taulukon uuden pituuden.', example: `arr.push(2);
@@ -32,7 +32,7 @@ export default { name: 'concat', shortDesc: 'tämän taulukon toiseen taulukkoon', desc: - 'Palauttaa uuden taulukon, joka on yhdistää tämän ja toisen taulukon alkiot.', + 'Palauttaa uuden taulukon, johon on yhdistetty tämän ja toisen taulukon alkiot ja/tai muita arvoja.', example: `let arr2 = ['a', 'b', 'c'];
let arr3 = arr.concat(arr2);
console.log(arr3);`, From 825e87be9d3fe7ffaae29d08207aa312948749be Mon Sep 17 00:00:00 2001 From: Minna Nurmiluoto <44906587+minna-xD@users.noreply.github.com> Date: Sat, 21 Nov 2020 22:49:49 +0200 Subject: [PATCH 3/4] Typo fixes and other changes --- src/locale/fi/index.js | 6 +-- store/fi/index.js | 92 +++++++++++++++++++++--------------------- 2 files changed, 49 insertions(+), 49 deletions(-) diff --git a/src/locale/fi/index.js b/src/locale/fi/index.js index 15d22bd..f177b78 100644 --- a/src/locale/fi/index.js +++ b/src/locale/fi/index.js @@ -6,13 +6,13 @@ export default { add: 'lisätä', remove: 'poistaa', find: 'selvittää', - 'iterate by': 'iteroida', + 'iterate by': '', string: 'string', }, singleItem: 'yhden alkion/arvon', manyItems: 'yhden tai useamman alkion/arvon', primaryOptions: [ - 'lisätä alkioita tai muita taulukoita', + 'lisätä alkioita tai toisia taulukoita', 'poistaa alkioita', 'löytää alkioita', 'käydä alkioita läpi', @@ -23,7 +23,7 @@ export default { docsLink: 'Koko dokumentaatio', usage: 'Koodi', output: 'Tuloste', - title: 'JavaScriptin Taulukoiden pikaopas', + title: 'JavaScriptin taulukoiden pikaopas', subtitle: 'Löydä tarvitsemasi taulukkometodi ilman turhauttavaa dokumentaation selaamista', chooseLanguage: 'Valitse kieli', linkToObjectExplorer: 'Linkki Olioiden pikaoppaaseen', diff --git a/store/fi/index.js b/store/fi/index.js index 417f065..b4b5582 100644 --- a/store/fi/index.js +++ b/store/fi/index.js @@ -42,8 +42,8 @@ export default { removing: [ { name: 'splice', - shortDesc: 'alkion/alkioita taulukosta', - desc: 'Lisää ja/tai poistaa alkioita taulukosta', + shortDesc: 'alkioita taulukosta', + desc: 'Lisää ja/tai poistaa alkioita taulukosta.', example: `arr.splice(2, 1);
console.log(arr);`, output: `[5, 1]`, @@ -70,8 +70,8 @@ export default { name: 'slice', shortDesc: 'yhden tai useamman alkion tietystä kohdasta, koskematta alkuperäiseen taulukkoon', - desc: `slice()-metodi palauttaa typistetyn kopion alkuperäisestä taulukosta: kopioidusta taulukosta on poistettu tietyt elementit. Metodille voidaan antaa parametrinä joko vain kopioidun osataulukon alkuindeksi - (joilloin osataulukon loppuideksi oletetaan alkuperäisen taulukon viimeinen alkio) tai pilkulla erotettuna osataulukon alkuindeksin ja loppuindeksin. + desc: `slice()-metodi palauttaa typistetyn kopion alkuperäisestä taulukosta: kopioidusta taulukosta on poistettu tietyt elementit. Metodille voi antaa parametrina joko vain kopioidun osataulukon alkuindeksin + (jolloin osataulukon loppuindeksin oletetaan olevan alkuperäisen taulukon viimeinen alkio) tai pilkuin eroteltuna osataulukon alkuindeksin ja loppuindeksin. Alkuperäinen taulukko säilyy ennallaan.`, example: `let slicedArr = arr.slice(1);
console.log(arr);
@@ -84,16 +84,16 @@ export default { { name: 'join', shortDesc: 'yhdistää kaikki alkiot yhdeksi merkkijonoksi', - desc: `Yhdistää kaikki taulukon alkiot merkkijonoksi. Ilman parametriä metodi yhdistää alkiot sellaisenaan, mutta antamalla parametriksi esimerkiksi elements.join(' - + desc: `Yhdistää kaikki taulukon alkiot merkkijonoksi. Ilman parametria metodi yhdistää alkiot sellaisenaan, mutta antamalla parametriksi esimerkiksi elements.join(' - ') saat lopputulokseksi 5 - 1 - 8`, example: `console.log(arr.join());`, output: `'5,1,8'`, }, { name: 'toString', - shortDesc: 'palauttaa merkkijonon joka sisältää taulukon kaikki alkiot', + shortDesc: 'palauttaa merkkijonon, joka sisältää taulukon kaikki alkiot', desc: - 'Palauttaa merkkijonon joka sisältää taulukon ja kaikki sen alkiot.', + 'Palauttaa merkkijonon, joka sisältää taulukon kaikki alkiot.', example: `console.log(arr.toString());`, output: `'5,1,8'`, }, @@ -101,8 +101,8 @@ export default { name: 'toLocaleString', shortDesc: 'palauttaa lokalisoidun merkkijonon, joka sisältää taulukon kaikki alkiot.', - desc: `Tämä on hieman omituinen funktio. Palauttaa lokalisoidun merkkijonon, johon on yhdistetty taulukon jokainen alkio lokalisoituna. - Tämä on erittäin hyödyllinen päivämääräolioiden tai valuutan käsittelyssä. Tällä funktiolla on omituisia natiiveja abstraktioita, joten on parasta katsoa dokumentaatiota tätä käyttäessä.`, + desc: `Tämä on hieman omituinen metodi. Palauttaa lokalisoidun merkkijonon, johon on yhdistetty taulukon jokainen alkio lokalisoituna. + Tämä on erittäin hyödyllinen päivämäärien tai valuuttojen käsittelyssä. Tällä metodilla on kuitenkin omituisia natiiveja abstraktioita, joten on parasta katsoa dokumentaatiota tätä käyttäessä.`, example: `let date = [new Date()];
const arrString = arr.toLocaleString();
const dateString = date.toLocaleString();
@@ -113,9 +113,9 @@ export default { ordering: [ { name: 'reverse', - shortDesc: 'muuttaa taulukon järjestyksen lopusta alkuun', + shortDesc: 'muuttaa taulukon järjestyksen käänteiseksi', desc: - 'Muuttaa taulukon järjestyksen lopusta alkuun - ensimmäisestä alkiosta tulee viimeinen, ja viimeisestä alkiosta ensimmäinen.', + 'Muuttaa taulukon järjestyksen käänteiseksi: ensimmäisestä alkiosta tulee viimeinen ja viimeisestä alkiosta ensimmäinen.', example: `arr.reverse();
console.log(arr);`, output: `[8, 1, 5]`, @@ -123,12 +123,12 @@ export default { { name: 'sort', shortDesc: 'järjestää taulukon alkiot', - desc: `Järjestää taulukon alkiot ja palauttaa uudelleenjärjestyn taulukon. Sorts the elements of an array in place and returns the array.
+ desc: `Järjestää taulukon alkiot ja palauttaa uudelleenjärjestyn taulukon.

Tärkeä huomio: Jos tälle metodille ei anneta parametrina funktiota, jonka perusteella järjestäminen tapahtuu (compareFunction), alkiot järjestetään seuraavalla tavalla: muutetaan alkiot merkkijonoiksi ja verrataan niitä Unicode-merkkeinä toisiinsa. - Esimerkiksi, 'banaani' järjestetään ennen 'kirsikka':a. Mutta numeroiden kanssa, vaikka 9 pitäisi järjestää ennen 80, kun numerot muutetaan merkkijonoiksi, - '80' laitetaan ennen '9'. MDN-dokumentaatiossa tarkentavia lisätietoja.`, + Esimerkiksi "banaani" järjestetään ennen sanaa "kirsikka". Numeroita järjestäessä luvun 9 pitäisi tulla ennen lukua 80, mutta merkkijonoiksi muutettuna + "80" tulee ennen merkkijonoa "9". MDN-dokumentaatiossa on tarkentavia lisätietoja.`, example: `arr.sort();
console.log(arr);`, output: `[1, 5, 8]`, @@ -139,7 +139,7 @@ export default { name: 'length', shortDesc: 'tietää taulukon pituuden', desc: - 'Palauttaa taulukon pituuden, eli sen kuinka monta alkiota taulukossa on.', + 'Palauttaa taulukon pituuden, eli sen, kuinka monta alkiota taulukossa on.', example: `console.log(arr.length);`, output: `3`, }, @@ -148,7 +148,7 @@ export default { shortDesc: 'täyttää taulukon kaikki alkiot samalla staattisella arvolla', desc: - 'Täyttää kaikki taulukon määritellyt alkiot samalla staattisella arvolla. Parametrina annetaan täytettävien alkioiden aloitusindeksi, ja vapaavalintaisesti pilkulla erotettuna loppuideksi.', + 'Täyttää kaikki taulukon määritellyt alkiot samalla staattisella arvolla. Parametreina annetaan staattinen arvo ja vapaavalintaisesti täytettävien alkioiden alkuindeksi ja/tai loppuindeksi.', example: `arr.fill(2);
console.log(arr);`, output: `[2, 2, 2]`, @@ -157,7 +157,7 @@ export default { name: 'copyWithin', shortDesc: 'kopioida taulukon osan samaan taulukkoon', desc: - 'Kopioi taulukon osan samaan taulukkoon, muuttamatta taulukon pituutta. Voit antaa parametrinä kohdealkion indeksin, ja sen lisäksi kopioinnin alkuideksin ja loppuideksin.', + 'Kopioi taulukon osan samaan taulukkoon, muuttamatta taulukon pituutta. Voit antaa parametrina vain loppualkion indeksin (jolloin alkuindeksi on 0) tai alkuindeksin ja loppuindeksin pilkulla eroteltuna.', example: `arr.copyWithin(1);
console.log(arr);`, output: `[5, 5, 1]`, @@ -166,9 +166,9 @@ export default { iterate: [ { name: 'forEach', - shortDesc: 'kirjoittamani funktion jokaisella alkiolle', + shortDesc: 'käsitellä jokaisen alkion kirjoittamallani funktiolla', desc: - 'forEach()-metodi suorittaa annetun funktion taulukon jokaiselle alkiolle, ja muokkaa taulukkoa.', + 'forEach()-metodi suorittaa annetun funktion taulukon jokaiselle alkiolle ja muokkaa taulukkoa.', example: `arr.forEach((element) => {
  console.log(element)
});`, @@ -179,7 +179,7 @@ export default { { name: 'map', shortDesc: - 'uuden taulukon vanhoista alkioista, joita on käsitelty funktiolla', + 'luoda uuden taulukon vanhoista alkioista, joita on käsitelty funktiolla', desc: 'Luo uuden taulukon, jonka alkiot ovat vanhan taulukon alkioiden ja parametrina annetun funktion tulos.', example: `let map = arr.map(x => x + 1);
@@ -188,14 +188,14 @@ export default { }, { name: 'entries', - shortDesc: 'iteraatio-oliolla', + shortDesc: 'luoda iteraatio-olion', desc: `Palauttaa iteraatio-olion, joka sisältää avain/arvo-parit taulukon jokaisesta alkiosta. - Iteraatio-olioille on paljon käyttötapauksia, kuten samankaltaisille esimerkiksi values and keys-metodeille.`, + Iteraatio-olioille on paljon käyttötapauksia, ja entries-metodin kaltaisia metodeja ovat myös values ja keys.`, example: `let iterator = arr.entries();
console.log(iterator.next().value);`, output: `[0, 5]
- // the 0 is the index,
- // the 5 is the first number`, + // 0 on indeksi,
+ // 5 on ensimmäinen numero`, }, ], find: { @@ -204,23 +204,23 @@ export default { name: 'includes', shortDesc: 'sisältääkö taulukko tietyn alkion', desc: - 'Selvittää sisältääkö taulukko tietyn alkion, palauttaa boolean-arvon.', + 'Selvittää, sisältääkö taulukko tietyn alkion. Palauttaa boolean-arvon.', example: `console.log(arr.includes(1));`, output: `true`, }, { name: 'indexOf', - shortDesc: 'alkion ensimmäisen esiintymän indeksin', + shortDesc: 'missä indeksissä alkio esiintyy ensimmäisen kerran', desc: - 'Palauttaa sen indeksin, jossa sijaitsee parametrina annettu alkio. Palauttaa -1, jos parametrina annettua alkiota ei löydy.', + 'Palauttaa indeksin, jossa parametrina annettu alkio sijaitsee. Palauttaa -1, jos alkiota ei löydy.', example: `console.log(arr.indexOf(5));`, output: `0`, }, { name: 'lastIndexOf', - shortDesc: 'alkion viimeisen esiintymän indeksin', + shortDesc: 'missä indeksissä alkio esiintyy viimeisen kerran', desc: - 'Palauttaa viimeisen (tai suurimman) indeksin, josta etsitty alkio löytyy. Palauttaa -1 jos alkiota ei löydy taulukosta.', + 'Palauttaa viimeisen (eli suurimman) indeksin, josta etsitty alkio löytyy. Palauttaa -1, jos alkiota ei löydy.', example: `console.log(arr.lastIndexOf(5));`, output: `0`, }, @@ -229,17 +229,17 @@ export default { shortDesc: 'ensimmäisen alkion, joka toteuttaa ehdon', desc: `Palauttaa alkion, joka toteuttaa annetun funktion ehdon. Palauttaa undefined, jos tällaista alkiota ei löydy. Samanlainen kuin findIndex()-metodi, mutta palauttaa alkion, eikä alkion indeksiä.`, - example: `let isTiny = (el) => el < 2;
- console.log(arr.find(isTiny));`, + example: `let onPieni = (el) => el < 2;
+ console.log(arr.find(onPieni));`, output: `1`, }, { name: 'findIndex', - shortDesc: 'ensimmäisen alkion indeksin, joka toteuttaa ehdon', + shortDesc: 'missä indeksissä esiintyy ensimmäinen alkio, joka toteuttaa ehdon', desc: `Palauttaa alkion, joka toteuttaa annetun funktion ehdon. Palauttaa -1, jos tällaista alkiota ei löydy. - Samanlainen kuin find()-metodi, mutta palauttaa alkion indeksi, ei alkiota..`, - example: `let isBig = (el) => el > 6;
- console.log(arr.findIndex(isBig));`, + Samanlainen kuin find()-metodi, mutta palauttaa alkion indeksi, ei alkiota.`, + example: `let onIso = (el) => el > 6;
+ console.log(arr.findIndex(onIso));`, output: `2`, }, { @@ -247,7 +247,7 @@ export default { shortDesc: 'mihin arvoon taulukon arvot kertyvät kertymäfunktiolla, alusta loppuun', desc: - 'Tällä metodille annetaan parametrinä kertymäfunktio, jolle puolestaan annetaan parametrinä taulukon jokainen alkio kerrallaan (vasemmalta oikealle). Metodi palauttaa yhden arvon, johon kertymäfunktio on supennut.', + 'Tälle metodille annetaan parametrina kertymäfunktio, jolle puolestaan annetaan parametrina taulukon alkiot yksi kerrallaan (vasemmalta oikealle). Metodi palauttaa kertymäfunktion lopputuloksen.', example: `let reducer = (a, b) => a + b;
console.log(arr.reduce(reducer));`, output: `14`, @@ -255,9 +255,9 @@ export default { { name: 'reduceRight', shortDesc: - 'mihin arvoon taulukon arvot kertyvät kertymäfunktiolla, loppusta alkuun', + 'mihin arvoon taulukon arvot kertyvät kertymäfunktiolla, lopusta alkuun', desc: - 'Tällä metodille annetaan parametrinä kertymäfunktio, jolle puolestaan annetaan parametrinä taulukon jokainen alkio kerrallaan (oikealta vasemmalle). Metodi palauttaa yhden arvon, johon kertymäfunktio on supennut.', + 'Tälle metodille annetaan parametrina kertymäfunktio, jolle puolestaan annetaan parametrina taulukon alkiot yksi kerrallaan (oikealta vasemmalle). Metodi palauttaa kertymäfunktion lopputuloksen.', example: `[arr, [0, 1]].reduceRight((a, b) => {
  return a.concat(b)
}, [])`, @@ -267,9 +267,9 @@ export default { many: [ { name: 'filter', - shortDesc: 'ne alkiot jotka toteuttavat annetun ehdon', + shortDesc: 'kaikki alkiot, jotka toteuttavat annetun ehdon', desc: - 'Luo uuden taulukon niistä alkioista, jotka toteuttavat annetun ehtofunktion.', + 'Luo uuden taulukon alkioista, jotka toteuttavat annetun ehtofunktion.', example: `let filtered = arr.filter(el => el > 4);
console.log(filtered)`, output: `[5, 8]`, @@ -278,18 +278,18 @@ export default { name: 'every', shortDesc: 'toteuttavatko kaikki alkiot annetun ehdon', desc: - 'Palauttaa true jos kaikki taulukon alkiot toteuttavat annetun ehtofunktion.', - example: `let isSmall = (el) => el < 10;
- console.log(arr.every(isSmall));`, + 'Palauttaa true, jos kaikki taulukon alkiot toteuttavat annetun ehtofunktion.', + example: `let onPieni = (el) => el < 10;
+ console.log(arr.every(onPieni));`, output: `true`, }, { name: 'some', shortDesc: 'toteuttaako yksikään alkio annettua ehtoa', desc: - 'Palauttaa true jos ainakin yksi alkio toteuttaa annetun ehtofunktion.', - example: `let biggerThan4 = (el) => el > 4;
- console.log(arr.some(biggerThan4));`, + 'Palauttaa true, jos ainakin yksi alkio toteuttaa annetun ehtofunktion.', + example: `let isompiKuin4 = (el) => el > 4;
+ console.log(arr.some(isompiKuin4));`, output: `true`, }, ], From 2518bbdcae6ec96c531ca89c4b70954c9d717af1 Mon Sep 17 00:00:00 2001 From: Senja Jarva Date: Wed, 2 Dec 2020 10:10:43 +0200 Subject: [PATCH 4/4] Add sjarva and minna-xD to README to list of translation providers --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index b326876..6dde537 100644 --- a/README.md +++ b/README.md @@ -29,7 +29,7 @@ I've heard people say they want to fork this project for other languages and dat ## Thank you! -Many thanks to everyone who helped with the translations! @AWolf81, @Gonzalo2310, @welll, @julienmartin, @g-plane, @imbyurhan, @bahe007, @salahaa1, @proYang, @bdimitrovski, @TheElderMindseeker, @glenngijsberts, @galuhsahid, @xgebi +Many thanks to everyone who helped with the translations! @AWolf81, @Gonzalo2310, @welll, @julienmartin, @g-plane, @imbyurhan, @bahe007, @salahaa1, @proYang, @bdimitrovski, @TheElderMindseeker, @glenngijsberts, @galuhsahid, @xgebi, @sjarva, @minna-xD ## Build Setup