WordStar 4.0

Dit is het programma waarin George R. R. Martin nog steeds A Song of Ice and Fire schrijft. Het kan worden opgestart op macOS, Windows en Linux zonder dat er extra software geïnstalleerd hoeft te worden.

Dit is geen kloon, eerbetoon of herschrijving. De bestanden in de map ws4/ zijn de originele, ongewijzigde binaries van MicroPro WordStar Professional Release 4 uit 1987. Wanneer u Ctrl-K X indrukt, is het exact dezelfde machinecode die destijds op een IBM PC/AT draaide die uw bestand opslaat.

WordStar is een 16-bit MS-DOS-programma. Omdat moderne besturingssystemen dit niet direct kunnen uitvoeren (Apple heeft 16-bit code verwijderd, 64-bit Windows weigert DOS-apps en Linux ondersteunt standaard geen DOS), is deze repository verpakt in DOSBox Staging. Dit is reeds gebundeld voor alle drie de platformen, waardoor u slechts op één icoon hoeft te klikken. Er is geen installatie, configuratie of internetverbinding vereist.

Wat is het?

VersieBeste voor...Kenmerken
🖥️ DesktopEcht schrijvenDubbelklik op een launcher → WordStar opent in een venster. Uw documenten zijn echte bestanden in de map drive/.
🌐 BrowserDirect uitproberenWordStar gecompileerd naar WebAssembly. Open een pagina en begin met typen. Niets te installeren.

Beide versies maken gebruik van dezelfde WordStar-binaries.

Installatie in 30 seconden

Haal de bestanden op door deze repository te klonen of de ZIP-map te downloaden en uit te pakken.

Opstarten per besturingssysteem

  • 🍎 macOS: Dubbelklik op WordStar.command.
  • Let op: Bij de eerste keer moet u met de rechtermuisknop klikken en kiezen voor 'Open' om Gatekeeper te passeren.
  • <0xF0><0x9F><0xAA><0x9F> Windows: Dubbelklik op WordStar.bat.
  • Let op: Bij de eerste keer kan SmartScreen verschijnen; kies 'Meer informatie' → 'Toch uitvoeren'.
  • 🐧 Linux: Voer ./wordstar.sh uit in een terminal.
  • WordStar.desktop werkt via bestandsbeheerders die lokale .desktop-bestanden toestaan (rechtermuisknop → 'Uitvoering toestaan').

Bij de eerste lancering wordt uw persoonlijke map drive/ aangemaakt (dit is uw WordStar-schijf met het programma en alles wat u schrijft) en komt u terecht in het startmenu van WordStar. Daarna opent het programma direct.

Direct aan de slag: Druk op D om een document aan te maken, geef het een naam (bijv. LETTER.DOC) en begin met schrijven. Gebruik Alt-Enter voor volledig scherm. Sla uw werk vaak op met Ctrl-K S, aangezien WordStar geen autosave-functie heeft.

De installatie is nu voltooid. Er hoeft geen aparte DOSBox geïnstalleerd te worden; een privékopie voor uw OS zit al in de map. Alles werkt volledig offline. (Indien dosbox-staging of dosbox al in uw PATH staat, gebruikt de launcher automatisch die versie).

Snelcursus besturing

WordStar stamt uit een tijd vóór de muis en wordt aangestuurd via Ctrl-commando's (hier genoteerd als ^, waarbij ^KS betekent: Ctrl-K gevolgd door S):

CommandoActieCommandoActie
^KSOpslaan en doorgaan^KXOpslaan en WordStar afsluiten
^KDOpslaan en terug naar menu^KQAfsluiten ZONDER op te slaan
^YHele regel verwijderen^TVolgende woord verwijderen
^UOngedaan maken (un-erase)^BAlinea opnieuw uitlijnen (re-flow)
$\leftrightarrow$Cursor verplaatsen^JHelp
Alt-EnterVolledig scherm

Startmenu:

  • D: Document openen of aanmaken.
  • P: Printen.
  • X: Terugkeren naar DOS.

Het meegeleverde bestand WELCOME.DOC begeleidt u verder. De volledige handleiding bevat tien lessen, alle commando's, informatie over seriebrieven en probleemoplossing.

De browserversie

Voor een ervaring zonder installatie kan WordStar in een webpagina worden gedraaid:

cd web && python3 -m http.server 8000
# Open daarna http://localhost:8000 in uw browser

WordStar start direct in het startmenu. Uw werk wordt automatisch opgeslagen in de browser. Om kopieën naar uw computer te downloaden, slaat u het bestand eerst op in WordStar (Ctrl-K S) en klikt u vervolgens op ⬇ Download files in de bovenbalk. De bestanden worden opgeslagen als leesbare tekstbestanden.

Opmerking: De site vereist een kleine lokale server in plaats van een file:// klik, omdat browsers WebAssembly niet direct vanaf het bestandssysteem laden. Alle Ctrl-toetsen werken ook hier.

Bestandsbeheer

Alles wat u schrijft is een echt bestand in de map drive/ naast de launcher (binnen WordStar is dit schijf C:):

  • drive/LETTER.DOC: Uw geschreven tekst (in het eigen formaat van WordStar).
  • drive/LETTER.BAK: Automatische backup van de vorige opslag.

Als u per ongeluk iets heeft verwijderd, vindt u de laatste versie in het bijbehorende .BAK-bestand. Bestandsnamen volgen de DOS-stijl 8.3 (maximaal 8 tekens, een punt, maximaal 3 tekens, bijv. CHAPTER1.DOC).

Tekstformaten en conversie

WordStar slaat in de normale "document-modus" op in een eigen formaat uit de jaren 80. Hierbij wordt een 'high bit' gezet bij de laatste letter van elk woord en bij elke regelafbreking. Hierdoor ziet de tekst er in moderne editors zoals Kladblok of TextEdit vervormd uit (bijv. thE quicK browN foX).

Er zijn twee manieren om schone, moderne tekst te verkrijgen:

  1. Conversiescripts: Gebruik scripts/convert-drive.sh (macOS/Linux) of scripts/convert-drive.ps1 (Windows). Deze zetten elke .DOC in drive/ om naar UTF-8 tekst in drive/doc-to-txt conversions/. De originelen blijven ongewijzigd.
  2. Niet-document-modus: Druk in het startmenu op N in plaats van D. Dit slaat gewone platte tekst op, maar u verliest hiermee de functies voor automatische regelafbreking en formattering.

Afhankelijkheden en offline gebruik

De desktop-launchers maken gebruik van DOSBox Staging. U hoeft dit niet zelf te installeren; een kopie voor elk OS is opgenomen in deze repository onder native/bin/.

Dit kan op drie manieren worden gerealiseerd:

  • Bundeled: Clone of unzip en start direct.
  • Scripts: Gebruik scripts/fetch-dosbox.sh of .ps1 om de versie bij te werken.
  • Offline Bundle: Een GitHub Action produceert WordStar-4-portable.zip, wat een complete ervaring biedt zonder internetverbinding.

De browserversie publiceren (optioneel)

Voor een permanente, deelbare URL:

  1. Push deze repository naar GitHub.
  2. Ga naar SettingsPagesSource: GitHub Actions.
  3. De inbegrepen pages.yml workflow implementeert de map web/ naar https://<gebruiker>.github.io/<repo>/.

Overzicht van de repository

  • ws4/: Originele WordStar 4 binaries.
  • docs/MANUAL.md: Volledige gebruikershandleiding.
  • docs/QUICK-REFERENCE.md: Printbare spiekbrief met toetscombinaties.
  • docs/WELCOME.DOC: Startdocument (opent in WordStar).
  • config/: DOSBox configuraties (web + desktop).
  • web/: Browserversie (js-dos / DOSBox-WASM) + index.html.
  • WordStar.command: macOS launcher.
  • WordStar.bat: Windows launcher.
  • wordstar.sh: Linux launcher (terminal).
  • WordStar.desktop: Linux launcher (bestandsbeheer).
  • native/lib/: Interne launcher-logica.
  • native/bin/: Gebundelde DOSBox per OS.
  • scripts/: Conversiescripts (DOCtxt), fetch-dosbox en build-web.sh.
  • .github/workflows/: Automatiseringen voor de offline zip en de browser-site.

Notities en licenties

WordStar is eigendom van de respectievelijke rechthebbenden. Deze binaries worden breed gedistribueerd als abandonware; dit project voegt enkel de wrapper toe om ze uit te voeren en claimt geen eigendom over WordStar zelf.

  • DOSBox Staging: GPL-licentie.
  • Browserversie (js-dos): GPL-licentie.
  • Wrapper-code: De launchers, scripts, web-glue en documentatie in deze repository vallen onder de MIT-licentie.

“Het is weer 1987. Veel plezier.”