{"id":13610291,"url":"https://ganelson.github.io/inform-website/","last_synced_at":"2025-04-12T22:33:34.425Z","repository":{"id":103786315,"uuid":"519904146","full_name":"ganelson/inform-website","owner":"ganelson","description":"The Inform programming language website.","archived":false,"fork":false,"pushed_at":"2024-04-25T05:48:49.000Z","size":30052,"stargazers_count":9,"open_issues_count":0,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-05-21T12:59:06.722Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"artistic-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ganelson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-07-31T22:53:40.000Z","updated_at":"2024-04-25T05:48:52.000Z","dependencies_parsed_at":"2023-03-13T15:05:57.669Z","dependency_job_id":null,"html_url":"https://github.com/ganelson/inform-website","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ganelson%2Finform-website","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ganelson%2Finform-website/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ganelson%2Finform-website/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ganelson%2Finform-website/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ganelson","download_url":"https://codeload.github.com/ganelson/inform-website/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248641910,"owners_count":21138294,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T19:01:43.328Z","updated_at":"2025-04-12T22:33:34.419Z","avatar_url":"https://github.com/ganelson.png","language":"HTML","funding_links":[],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"readme":"# inform-website\nThe home page for the Inform website.\n\nThis repository serves the home page `inform7.com` for\nthe [Inform programming language](https://github.com/ganelson/inform), using GitHub pages.\nThe site is very simple, containing only a copy of the current documentation,\na few news items, and a collection of links to other resources.\n\nAt present, the domain name `inform7.com` simply redirects to the GitHub Pages\nURL for this repository, that is, `https://ganelson.github.io/inform-website/`.\nAt some point the DNS records for the domain name may move it here permanently\nso that no redirection is needed.\n\n## How to update the site\n\nContent in the `docs` is automatically run through the Jekyll static website maker:\nsee the relevant [GitHub documentation](https://docs.github.com/en/pages). Roughly\nspeaking, Markdown is converted to HTML, certain braced variables like `{{ site.baseurl }}`\nare replaced by their values, and blog posts in the [docs/_posts](docs/_posts)\ndirectory are arranged nicely, with filenames such as:\n\n\t2022-07-31-narrascope-iii.markdown\n\nbecoming the URL:\n\n\ttalks/2022/07/31/narrascope-iii.html\n\nNote that the site metadata file `docs/_config.yml` is not converted and has a\nspecial meaning to Jekyll: it's short and to the point, and unlikely to need\nalteration.\n\nBinaries of old copies of the Inform apps are not stored on this server because\nthey would balloon the repository to about 1.4 GB. Instead, they're currently\nhoused at `emshort.com/inform-app-archive`. In due course they may move.\nBecause they correspond to versions of Inform before it was tracked by Git,\nthey can't be made \"releases\" in the GitHub sense.\n\n### How to add new pages\n\nAdding a file `docs/whatever.md` would create a new top-level page, which\nwould then automatically be part of the navigation menu. Though otherwise\nwritten in Markdown, this is expected to contain a few lines of Jekyll\ninstructions at the top. This would do it:\n\n\t---\n\tlayout: page\n\ttitle: Whatever\n\tpermalink: /whatever/\n\t---\n\n### How to add new blog items\n\nCreating a file `docs/_posts/YYYY-MM-DD-short-url-here.md` adds a blog post.\nThis too should open with some Jekyll incantation:\n\n\t---\n\tlayout: post\n\ttitle:  \"Title of the blog post here\"\n\tdate:   YYYY-MM-DD 15:30:00 +0600\n\tcategories: talks\n\t---\n\nAny categories can be used. Note that the `YYYY-MM-DD` date in this header\nshould match the one in the filename. The time of day is irrelevant for a\nlow-traffic blog like this one.\n\n### How to update the Inform documentation served here\n\nThe path `docs/book` contains a complete HTML copy of the Inform in-app\nmanuals \"Writing with Inform\" and \"The Inform Recipe Book\". This is all\nprocessed by Jekyll to become the actual site, but in practice the files are\nall literal HTML or CSS and they pass through Jekyll unchanged.\n\nTo update this, clone the repository so that it sits beside the `inform`\nrepository. For example, your local copies might look like so:\n\n\twork\n\t\tinform\n\t\tinform-website\n\nThe `inform` repository contains the documentation-generating tool `indoc`\nand also the source matter for the two manuals. You'll need to build that\nfirst, so that you have a working `indoc`. Then:\n\n\tcd inform-website\n\tmake books\n\nand wait for a few seconds.\n\nThe mystery file `book_nav.html` at the root of this repository is what\ndefines the navigation bar at the top of the manual pages.\n\nIndoc is otherwise configured for this run by the file \nnewwebsite `resources/Documentation/indoc-instructions.txt` in the main\nInform repository. Note that the \"platform\" for these purposes is `newwebsite`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/ganelson.github.io%2Finform-website%2F","html_url":"https://awesome.ecosyste.ms/projects/ganelson.github.io%2Finform-website%2F","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/ganelson.github.io%2Finform-website%2F/lists"}