ifhub/inform7
1
0
Fork 0
mirror of https://github.com/ganelson/inform.git synced 2024-07-02 23:14:57 +03:00
Code Issues Projects Releases Wiki Activity
(Mirror with no changes) The core software distribution for the Inform 7 programming language.
53 commits 2 branches 3 tags 159 MiB
C 53.2%
CWeb 28.9%
Inform 7 14%
HTML 3%
CSS 0.6%
Other 0.2%
Go to file
Graham Nelson 086db131f3 Fixed two minor make infelicities
2019-03-17 19:45:41 +00:00
docs Moved to up to date dumb-glulx, and added its version to README.md 2019-03-17 19:24:29 +00:00
inblorb Fixed batch-testing misconfiguration 2019-03-17 13:48:15 +00:00
indoc Fixed batch-testing misconfiguration 2019-03-17 13:48:15 +00:00
inform6 Moved to up to date dumb-glulx, and added its version to README.md 2019-03-17 19:24:29 +00:00
inform7 Moved to up to date dumb-glulx, and added its version to README.md 2019-03-17 19:24:29 +00:00
inpolicy Moved to up to date dumb-glulx, and added its version to README.md 2019-03-17 19:24:29 +00:00
inrtps Tidied up inrtps 2019-02-27 19:29:15 +00:00
inter Incorporated GitHub pages 2019-03-17 12:40:57 +00:00
resources Fixed batch-testing misconfiguration 2019-03-17 13:48:15 +00:00
retrospective Initial commit 2019-02-05 00:44:07 +00:00
scripts Fixed two minor make infelicities 2019-03-17 19:45:41 +00:00
srules Tidied up metadata 2019-03-16 17:36:11 +00:00
.gitignore Reorganised main inform repository 2019-03-16 13:12:11 +00:00
README.md Moved to up to date dumb-glulx, and added its version to README.md 2019-03-17 19:24:29 +00:00

README.md

Inform 7 version 7.10.1 'Krypton' (build 6Q21)

About Inform 7

Inform 7 (April 2006-) is a programming language for creating interactive fiction, using natural language syntax. Using natural language and drawing on ideas from linguistics and from literate programming, Inform is widely used as a medium for literary writing, as a prototyping tool in the games industry, and in education, both at school and university level (where Inform is often assigned material for courses on digital narrative). It has several times ranked in the top 100 most influential programming languages according to the TIOBE index.

Licence

Except as noted, copyright in material in this repository (the "Package") is held by Graham Nelson (the "Author"), who retains copyright so that there is a single point of reference. As from the first date of this repository becoming public, the Package is placed under the Artistic License 2.0. This is a highly permissive licence, used by Perl among other notable projects, recognised by the Open Source Initiative as open and by the Free Software Foundation as free in both senses.

For the avoidance of doubt, the Author makes the further grant that users of the Package may make unlimited use of story files produced by the Package: such story files are not derivative works of Inform and do not inherit the Artistic License 2.0 as an obligation. (This further grant follows the practice of projects like bison, which also copy substantial code into their outputs.)

Repositories

This is the "core repository", holding source code for the compiler, and for everything needed to run it on the command line. However:

Build Instructions

Make a directory in which to work: let's call this "work". Then:

  • Clone and build Inweb into "work/inweb": repository here.
  • Clone and build Intest into "work/intest": repository here.
  • Clone Inform into "work/inform". Change the current directory to that. Then run "bash scripts/first.sh" (or whatever shell you prefer: it need not be bash). This should give you a complete working set of command-line Inform tools and associated makefiles. For any future builds, you can simply type "make".
  • For a simple test, try e.g. "inblorb/Tangled/inblorb -help". All the executables should similarly respond to -help.
  • But for a true test, run "make check". This compiles two more tools needed only for testing (dumb-frotz and dumb-glulx), then runs Intest on each tool in turn. Some haven't got a test suite, some have; it will run whatever it finds. Be advised that on a 2013 laptop this all takes quarter of an hour and sounds like a helicopter taking off.

Inventory

"I can't help feeling that if someone had asked me before the universe began how it would turn out, I should have guessed something a bit less like an old curiosity shop and a bit more like a formal French garden — an orderly arrangement of straight avenues, circular walks, and geometrically shaped trees and hedges." (Michael Frayn)

Inform is not a single program, but an assemblage of programs and resources. Some, including the inform7 compiler itself, are "literate programs", also called "webs". The notation ★ marks these, and links are provided to their human-readable forms. (This will be enabled when the repository becomes public: GitHub Pages does not work on private repositories.)

Resources for which this is the primary repository

This repository is where development is done on the following executables:

The inform7 subtree further contains these primary resources:

  • The I6 Template - The .i6t files used in code generation. Inform 6; held in inform7/Internal/I6T

  • inform7/Internal/Extensions - Libraries of code. Inform 7

    • inform7/Internal/Extensions/Emily Short/Basic Help Menu.i7x - unversioned

    • inform7/Internal/Extensions/Emily Short/Basic Screen Effects.i7x - version 7/140425

    • inform7/Internal/Extensions/Emily Short/Complex Listing.i7x - version 9

    • inform7/Internal/Extensions/Emily Short/Glulx Entry Points.i7x - version 10/140425

    • inform7/Internal/Extensions/Emily Short/Glulx Image Centering.i7x - version 4

    • inform7/Internal/Extensions/Emily Short/Glulx Text Effects.i7x - version 5/140516

    • inform7/Internal/Extensions/Emily Short/Inanimate Listeners.i7x - unversioned

    • inform7/Internal/Extensions/Emily Short/Locksmith.i7x - version 12

    • inform7/Internal/Extensions/Emily Short/Menus.i7x - version 3

    • inform7/Internal/Extensions/Emily Short/Punctuation Removal.i7x - version 5

    • inform7/Internal/Extensions/Emily Short/Skeleton Keys.i7x - unversioned

    • inform7/Internal/Extensions/Eric Eve/Epistemology.i7x - version 9

    • inform7/Internal/Extensions/Graham Nelson/Approximate Metric Units.i7x - version 1

    • inform7/Internal/Extensions/Graham Nelson/English Language.i7x - version 1

    • inform7/Internal/Extensions/Graham Nelson/Metric Units.i7x - version 2

    • inform7/Internal/Extensions/Graham Nelson/Rideable Vehicles.i7x - version 3

    • inform7/Internal/Extensions/Graham Nelson/Unicode Character Names.i7x - unversioned

    • inform7/Internal/Extensions/Graham Nelson/Unicode Full Character Names.i7x - unversioned

  • inform7/Internal/HTML - Files needed for generating extension documentation and the like

  • inform7/Internal/Languages - Natural language definition bundles

  • inform7/Internal/Templates - Template websites for Inform 7's 'release as a website' feature

    • inform7/Internal/Templates/Classic - An older, plainer website - unversioned

    • inform7/Internal/Templates/Standard - The default, more modern look - unversioned

The "resources" directory holds a number of non-executable items of use to the Inform UI applications, and to Inform websites:

  • Changes to Inform - A detailed change history of Inform 7. Ebook in Indoc format, stored at path resources/Changes.

  • Writing with Inform and the Inform Recipe Book - The main Inform documentation, as seen in the apps, and in standalone Epubs. Ebook in Indoc format, stored at path resources/Documentation.

  • resources/Outcome Pages - Inrtps uses these to generate HTML outcome pages (such as those showing Problem messages in the app)

  • resources/Sample Projects - Two small interactive fictions, 'Disenchantment Bay' and 'Onyx', presented as samples in the app. Inform 7

Finally, the "retrospective" directory holds ANSI C source and resources needed to build (some) previous versions of Inform 7. At present, this is only sketchily put together.

Resources copied here from elsewhere

Stable versions of the following are periodically copied into this repository, but this is not where development on them is done, and no pull requests will be accepted. (Note that these are not git submodules.)

Binary resources (such as image files)

  • resources/Imagery/app_images - icons for the Inform app and its many associated files, in MacOS format
  • resources/Imagery/bg_images - background textures used in the Index generated by Inform
  • resources/Imagery/doc_images - miscellaneous images needed by the documentation
  • resources/Imagery/map_icons - images needed for the World pane of the Index generated by Inform
  • resources/Imagery/outcome_images - images used on outcome pages
  • resources/Imagery/scene_icons - images needed for the Scenes pane of the Index generated by Inform
  • resources/Internal/Miscellany - default cover art, the Introduction to IF and Postcard PDFs

Other files and folders in this repository

  • docs - Woven forms of the webs, for serving by GitHub Pages (not yet added)
  • scripts/gitignorescript.txt - Inweb uses this to generate the .gitignore file at the root of the repository
  • scripts/makescript.txt - Inweb uses this to generate a makefile at the root of the repository
  • scripts/READMEscript.txt - Inpolicy uses this to generate the README.md file for the repository

Colophon

This README.mk file was generated automatically by Inpolicy, and should not be edited. To make changes, edit scripts/READMEscript.txt and re-generate.