lennertderyck / stambord Goto Github PK

Een nieuwe versie is onderweg ... Lees meer

Stambord is gemaakt met webtechnologie en we hebben ervoor gezorgd dat je je geen zorgen hoeft te maken over dependencies. Omdat het de bedoeling is dat je de applicatie offline kan gebruiken is er geen gebruik gemaakt van externe resources die een internetverbinding vereisen.

Stambord werd gemaakt met behulp van ...

• Bootstrap – interface
• Feather – Iconen
• Taffy.js – Json database ➡️ Dexie – Database
• Filesaver.js – Backupfunctie

Hardware
Een desktop-computer of laptop, voorlopig is er nog geen applicatie voor iPad of Android.

Platformen

• Windows 7 of hoger
• macOS 10.10 (Yosemite) of hoger
• Ubuntu 12.04 of hoger, Fedora 21, Debian 8 (andere platformen zijn niet gegarandeerd, maar je kan het zeker uitproberen.)

Voetnoot
Stambord wordt gemaakt met Electron, een framework om desktop applicaties te kunnen ontwikkelen met webtechnologieën. Electron maakt hier gebruik van Chromium van Google voor, het systeem waar ook Google Chrome op gebaseerd is.

Een goede vuistregel is dus; Als Chrome op je computer werkt, dan zal Stambord waarschijnlijk ook werken.

| Demo (wachtwoord: stamvader) | Download voor Windows en MacOS |

• Unzip de folder
• Zoek naar Stambord.exe en open het
• Krijg je een beveilingsmelding? Klik op 'Meer informatie' en dan op 'Toch uitvoeren'
• Na een paar seconden wachten is de app klaar voor gebruik
• Verplaats Stambord.exe naar waar je wilt

• Unzip de folder
• Zoek naar Stambord en open het
• Je krijgt waarschijnlijk een beveilingsmelding. Volg hier voor de volgende stappen
• Sluit de melding
• Ga naar Systeemvoorkeuren > Beveiliging en privacy > tabblad Algemeen
• Hier zal je een melding zien over deze app en een knop "Open toch"
• Na het aanklikken van deze knop wordt de applicatie normaal geopend en zal je deze stappen niet meer moeten doorlopen
• Verplaats Stambord naar je Apps folder

De reden achter deze beveiligingsmeldingen is het feit dat ik niet gecertificeerd ben door Apple of Microsoft omdat je hier jaarlijks voor moet betalen.

Voetnoot
Alle gegevens worden lokaal opgeslagen. Omdat er op vele scoutsen geen internet beschikbaar is hebben we er voor gezorgd dat alles op de computer zelf wordt opgeslagen. Maak dus regelmatig een backup via de ingebouwde functies (te vinden onder Instellingen).

Stambord is beschikbaar voor Windows en MacOS, maar indien je de app toch zelf wil packagen is dit ook mogelijk.

We zijn overgeschakeld van Electron-Forge naar Electron-packager

• Download stambord-master.zip
• Unzip stambord-master.zip door hier dubbel op te klikken
• Open Commandoprompt
• Controleer of Node.js geïnstalleerd is
  • Plak de volgende code node -v en druk Enter
  • Als Node.js niet geïnstalleerd is download deze dan via https://nodejs.org/en/
  • Volg de stappen voor de installatie

• Sleep de folder stambord-master naar het icoontje van Commandprompt
• Installeer Node packages npm install
• Plak het volgende in de Commandpromptnpm run package

Er zal in de map die je gedownload hebt een nieuwe folder gemaakt worden dat volgens het volgende patroon genaamd is: "stambord-darwin|win32-x64". Afhankelijk van je besturingsysteem zal er "darwin" (voor Mac) of "win32" staan (voor Windows).

Heb je een Windows-versie gemaakt? Laat me iets weten!

Om de code beheersbaar te houden hebben we de volledige applicatie herschreven.

• localStorage wordt vervangen door indexedDB
• Code wordt opgesplitst in modules
• Er wordt gebruik gemaakt van JavaScript 6
• Invoervelden worden nu aangesproken door API's en zo zijn er nog veel meer wijzigingen en verbeteringen.

Door gebruik te maken van enkele nieuwe functies van JavaScript (6) is het daarom belangrijk een back-up te maken van de gegevens (tabblad 'Instellingen') alvorens de nieuwe versie te installeren.

Een bijkomend voordeel van deze veranderingen is het makkelijker kunnen implementeren van nieuwe features, de applicatie bevat minder bugs en is stabieler.

Voor nu zijn deze wijzigingen te vinden op de canary-branch. Eens alle huidige functies opnieuw aanwezig zijn zullen de wijzigingen naar de master-branch gepushed worden.

| Bug raporteren | Suggestie insturen |

Dit project wordt semi-onderhouden, in de zin dat er aan gewerkt wordt wanneer school, werk en de scouts dit toelaten. Bij vragen of fouten in Stambord zijn we uiteraard bereid om ondersteuning te bieden waar mogelijk.

Maak voor problemen een nieuw bug report aan of mail voor hulp naar mij.