resources.yaml

libraries:
  - title: Beginners
    description: These are resources to get you up and running with TADS 3. They are repeated in the more comprehensive resources as well.
    resources:
      - title: TADS 3 Quickstart
        type: TADS 3 & Adv3
        author: Eric Eve
        description: This brief guide contains instructions for installing the TADS 3 workbench system and compiling a basic game. It also has explanation of the other documentation that exists, including guidance on where to go next, and a sample game newcomers can experiment with if they want to dive straight it.
        url: https://www.tads.org/t3doc/doc/t3QuickStart.htm
      - title: Quick reference charts
        type: TADS 3 & Adv3
        author: Eric Eve
        description: Some quick reference PDFs that summarize some of the essential information about the TADS 3 language and library.
        url: /quickrefs
      - title: adv3Lite Wiki
        type: adv3Lite
        author: Eric Eve
        description: This GitHub wiki aims to give users and potential users of adv3Lite the information they need to decide whether adv3Lite may be for them. There are links to adv3Lite installation and setup, a sample game, and a short primer on some coding concepts needed for adv3Lite.
        url: https://github.com/EricEve/adv3lite/wiki/Learning-adv3Lite
      - title: Interactive Fiction Forum community
        type: All of TADS 3
        description: The Intfiction.org forum is a place for fans and authors of interactive fiction to gather. It has a category for TADS 3 discussion where you can discuss the language and both current libraries, and ask for help from experienced TADS 3 authors and programmers.
        url: https://intfiction.org/c/authoring/tads/
  - title: Adv3
    description: Adv3 is the default TADS 3 library, and is packaged with it when you install TADS 3. It's rather complex, but has a lot of fidelity and powerful features.
    resources:
      - title: TADS 3 Quickstart
        author: Eric Eve
        description: This brief guide contains instructions for installing the TADS 3 workbench system and compiling a basic game. It also has explanation of the other documentation that exists, including guidance on where to go next, and a sample game newcomers can experiment with if they want to dive straight it.
        url: https://www.tads.org/t3doc/doc/t3QuickStart.htm
      - title: Quick reference charts
        author: Eric Eve
        description: Some quick reference PDFs that summarize some of the essential information about the TADS 3 language and Adv3 library.
        url: /quickrefs
      - title: Adv3 Periplus
        author: Jim Nelson
        description: A reorganized, hyperlinked, cross-referenced index of existing adv3 library source files and documentation. The narrative descriptions of classes, functions, methods, and so on are transcribed from the comments in the library source code.
        url: /docs/adv3/adv3index.html
      - title: Example Games
        type: Adv3 & adv3Lite
        author: Eric Eve
        description: A set of ten short games illustrating how to use various parts of the library in both adv3 and adv3Lite.
        url: https://users.ox.ac.uk/~manc0049/TADSGuide/Examples/exercises.htm
      - title: Cloak of Darkness
        type: Adv3 & adv3Lite 
        author: Eric Eve
        description: Cloak of Darkness is an example game that has been implemented across multiple interactive fiction languages to demonstrate how the same features can be implemented in different systems. This is a link to implementations of the Cloak of Darkness game in adv3Lite and adv3.
        url: https://users.ox.ac.uk/~manc0049/TADSGuide/cloak.htm
  - title: adv3Lite
    description: adv3Lite is a TADS 3 library based off Adv3, written and maintained by Eric Eve. It aims to provide a library that's easier to use than the Adv3 library, but which is almost as powerful and expressive. Adv3Lite misses out the bits that most games don't really need (like postures, room parts, and multiple light levels) while adding in some other bits that are often more useful (like scenes and regions, "borrowed" from Inform 7). Adv3Lite also cuts down drastically on the complexity of the Adv3 class hierarchy while maintaining much of their functionality.
    resources:
      - title: adv3Lite Wiki
        author: Eric Eve
        description: This GitHub wiki aims to give users and potential users of adv3Lite the information they need to decide whether adv3Lite may be for them. There are links to adv3Lite installation and setup, a sample game, and a short primer on some coding concepts needed for adv3Lite.
        url: https://github.com/EricEve/adv3lite/wiki/Learning-adv3Lite
      - title: Further information about adv3Lite
        author: Eric Eve
        description: The original home page of adv3Lite, giving a description of what it's for, how if differs from adv3, and links to various useful resources.
        url: https://users.ox.ac.uk/~manc0049/TADSGuide/adv3Lite.htm
      - title: adv3Lite Periplus
        author: Jim Nelson
        description: A reorganized, hyperlinked, cross-referenced index of existing adv3Lite library source files and documentation. The narrative descriptions of classes, functions, methods, and so on are transcribed from the comments in the library source code. The library source code is also provided as links.
        url: /docs/adv3Lite/adv3liteindex.html
      - title: Example Games
        type: Adv3 & adv3Lite
        author: Eric Eve
        description: A set of ten short games illustrating how to use various parts of the library in both adv3 and adv3Lite.
        url: https://users.ox.ac.uk/~manc0049/TADSGuide/Examples/exercises.htm
      - title: Cloak of Darkness
        type: Adv3 & adv3Lite 
        author: Eric Eve
        description: Cloak of Darkness is an example game that has been implemented across multiple interactive fiction languages to demonstrate how the same features can be implemented in different systems. This is a link to implementations of the Cloak of Darkness game in adv3Lite and adv3.
        url: https://users.ox.ac.uk/~manc0049/TADSGuide/cloak.htm
      - title: 
        author: 
        description: 
        url: 
      - title: 
        author: 
        description: 
        url: 
  - title: TADS 3 language
    description: These are references for the TADS 3 programming language itself, not specific to any library like Adv3 or Adv3Lite.
    resources:
      - title: TADS 3 System Manual
        author: Michael Roberts
        description: This book is a reference to the TADS 3 language and the T3 VM, including the standard intrinsic functions and classes. It covers the language and VM features in depth, so it's the place to go when you need to find the details on the system.  
        url: https://www.tads.org/t3doc/doc/sysman/cover.htm
      - title: Introduction to HTML TADS
        author: Michael Roberts
        description: A brief introduction to HTML TADS, a text adventure interpreter based on TADS. 
        url: https://www.tads.org/t3doc/doc/htmltads/intro.htm

quickrefs:
  - name: TLangRef.pdf
    description: A quick reference for the TADS 3 language itself
    url: /assets/quickrefs/T3LangRef.pdf
  - name: TemplatesQref.pdf
    description: A Templates Quick Reference
    url: /assets/quickrefs/TemplatesQref.PDF
  - name: DynamicCharacterQuickRef.pdf
    description: A Dynamic Actors Quick Reference (for creating NPCs)
    url: /assets/quickrefs/DynamicCharacterQuickRef.PDF
  - name: ActionMessages.pdf
    description: An Action Messages Quick Reference to help you find the message properties you need to override to customise responses quickly and easily.
    url: /assets/quickrefs/ActionMessages.PDF