Skip to content
GitLab
  • Menu
Projects Groups Snippets
  • /
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
  • zilf zilf
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Jira
    • Jira
  • Merge requests 1
    • Merge requests 1
  • Deployments
    • Deployments
    • Releases
  • Packages & Registries
    • Packages & Registries
    • Package Registry
    • Infrastructure Registry
  • Analytics
    • Analytics
    • Value stream
    • Repository
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Commits
Collapse sidebar
  • zilf
  • zilfzilf
  • Wiki
  • Getting Started

Getting Started · Changes

Page history
Update Getting Started authored Sep 01, 2020 by Tara McGrew's avatar Tara McGrew
Hide whitespace changes
Inline Side-by-side
Getting-Started.md
View page @ 22d2bbb3
......@@ -3,31 +3,22 @@
# Tools
* To **compile** ZIL code into playable Z-machine story files:
- [Download ZILF 0.9](/Releases/0.9/Downloads)
- Or, build the newest ZILF from [source code](https://foss.heptapod.net/zilf/zilf) with the [.NET Core 2.2 SDK](https://dotnet.microsoft.com/download/dotnet-core/2.2)
* To **edit and debug** ZIL code:
- [Visual Studio Code](https://code.visualstudio.com/)
- The [zil-language extension](https://marketplace.visualstudio.com/items?itemName=zilf.zil-language) for VS Code
* To **run** compiled Z-machine story files:
- [Gargoyle](http://ccxvii.net/gargoyle/)
- [Windows Frotz](http://www.davidkinder.co.uk/frotz.html)
- [Frotz](https://davidgriffith.gitlab.io/frotz/)
- ...or [many others](http://www.ifwiki.org/index.php/List_of_Z-machine_interpreters)
* To get **help**:
- [Zork Implementation Language group](https://www.facebook.com/groups/ZILcom/) on Facebook
- [ZILF Discord](https://discord.gg/eR98YMN)
- [ZILF subreddit](https://www.reddit.com/r/ZILF/)
- [IntFiction.org](https://www.intfiction.org/)
* To **report a bug** in ZILF:
- [JIRA](https://vaporware.atlassian.net/projects/ZILF/issues)
# Documentation
......@@ -36,14 +27,16 @@
* [ZIL Course](uploads/4016b870defd77716e4ab766e20989b4/ZILCourse.pdf) by Marc Blank
* [The MDL Programming Language](https://mdl-language.readthedocs.io/en/latest/) by Stu Galley and Greg Pfister
* [The Z-Machine Standards Document](http://www.inform-fiction.org/zmachine/standards/z1point1/index.html)
* [ZIP: Z-language Interpreter Program]() by Joel Berez, Marc Blank, and David Lebling
* [ZIP: Z-language Interpreter Program](uploads/zip.pdf) by Joel Berez, Marc Blank, and David Lebling
## Test Suite
* [ZILF library tests](https://foss.heptapod.net/zilf/zilf/-/tree/branch/default/zillib/tests)
- Demonstrates the use of features from ZILF's parser and world library.
Demonstrates the use of features from ZILF's parser and world library.
* [ZILF integration tests](https://foss.heptapod.net/zilf/zilf/-/tree/branch/default/test/Zilf.Tests.Integration)
- Demonstrates the use of features in MDL and ZIL, as implemented by ZILF.
Demonstrates the use of features in MDL and ZIL, as implemented by ZILF.
# Examples
......
Clone repository
  • Getting Started
  • Releases
    • 0.9
      • Downloads
      • Release Notes
  • Home