Skip to content

About

Thank you for viewing this tutorial! This page isn't a part of the tutorial, but rather a general information page about the tutorial itself.

This website is available in these locations:

Authors

Authors are people who have directly contributed to the text, via the Git repository for this site.

Contributors

Contributors are those who are credited and acknowledged as having contributed to this tutorial from the time of its official release.

  • None as of yet

Roadmap

TODO

  • Finish the base tutorial
    • Finish the Introduction section
    • Finish the Basics section
    • Finish the Mechanics section
      • Rows
      • Objects / Choices
      • Addons
      • Backpack & Choice Import
      • IDs & Requirements
      • Points & Scores
      • Images
      • Defaults
      • Words
      • Buttons (& Variables)
      • Groups
    • Finish the Styling section
      • Design – Basically like, design theory
      • Style Templates
      • Colours – How you should choose colour, where to put it
      • Backgrounds
        • Link to static background in Reference, or vice versa
      • Text
      • Rows / Row Design (to not confuse it with Mechanics/Rows)
        • Row Images
      • Choices / Choice Design (see above)
        • Choice Images
      • Filters
      • Point Bar
      • Multi-Choice
      • The Backpack
      • Private Styling
    • Finish the Creating Your CYOA section
      • Section detailing actual mechanical design choices, such as whether to include perks, drawbacks, balancing, etc. Essentially the Mechanics equivalent to the Styling section's Design page.
    • Finish the Extending Your CYOA section
    • Finish the Publishing section
      • Publishing (page)
      • Static
      • Neocities
      • GitHub
    • Finish the Reference section
    • Finish the Troubleshooting section
    • Finish the Resources section – Will this and the above two ever truly be finished?
  • Add a End-of-tutorial Project where there's a step by step remake of a CYOA.
  • After the ICCT is written, go through the main tutorial and add everything that is possible into the Mechanics
    • e.g., in the Backgrounds page, make a section on making static backgrounds, and link to the Reference
  • Chill with the quotes, and instead rewrite the quotes into information in my own words.
  • Add my own custom Viewer js file, this time adding:
    • alt attribute for <img>s
    • referrerpolicy attribute for <a> links
  • Change template example images in the Style Templates section to include buttons that are being pressed, images, and other elements
  • Specify that content indicated by a !!! quote admonition and in code blocks (when explicitly said or noted as quoted) as not licensed under the content licence.
  • Finish the Publishing section and then upload it to Reddit
    • Finish the Publishing section
    • Upload it to Reddit
      • I may have to upload it to r/NSFWCYOA instead of r/makeyourchoice, considering the fact that I both include some NSFW images and also link to a lot of NSFW material in the Resources section
  • Add the version of the Tutorial in the header or footer somewhere
  • In the Design section, speak imperatively. Say Do this and Don't do that instead of just quoting people and pointing toward them. I need to put all the data all in one spot.
  • Add Cheat Engine example to Extending Your CYOA
  • End all list items in Resources with full stops or without (for consistency)
  • Add speed comparison between Neocities and GitHub
  • Under Styling/Backgrounds add examples of where the image upload buttons are if you didn't stay zoomed out, and instead zoomed back in to show the image upload bugged choices
  • Make a script like here which receives a URL or project.json, goes through all links to images, fetches them, then converts them into Base64 encoded images and puts them locally. Make it open-source and MIT.
  • Add Lt Ourovmov's Viewer to the static/ folder with the other Viewer files
    • Use that Viewer with my GitHub template
    • Merge it with the other modded Viewer I have to create the Ultimate® Viewer
  • Make a macro to list all files in a directory, and use it for static/
  • Add red outlines around the buttons in the Basics section, as that of all places should be clearer

Completed

  • Compress all the gifs to limit bandwidth, but not enough such that the gifs lose legibility. Use gifsicle in a python script.
  • Find a way to count words and characters
  • Make a chapter detailing how to actually create ICYOAs
    • Section on OCR, including my command line tool, caveats, etc
    • Section on finding the text, seeing if there's a Google Doc – Mentioning possibly asking the authors for a text version
    • Section on handwriting it
    • Advice on asking the author if they have a Google Doc of it, so that you can more easily copy it?
  • Consider changing the content licence to CC0 (Public Domain).
  • Add tip block when talking about the Viewer, mentioning that projects automatically start at the index.html, meaning they don't need to include that in the title (and it looks nicer)
  • Delete unneeded JavaScript

Scrapped

  • Add JavaScript to show when, from now, a release happened
  • Standardize "after"/"result"/"with" and "before"/"without" etc tabbed titles
  • Delete ideologically-driven information, such as git. The people most likely do not need nor want to know that.
  • Add a section detailing how to get pages.dev, netlify.app, etc.
  • Add surge.sh hosting option (unlimited bandwidth)

Changelog

v0.18.0 (WIP)

  • Added links to static/
  • Switch to using the Git commit as the date shown on releases now, rather than the GitHub release#using-the-web
  • Posted this to Reddit! (TODO: link)
  • Updated Resources
  • Made stats publicly viewable
  • Adjusted word count stat from previous release (in accordance with the rule up top)
  • Updated mkdocs-material from version 9.2.0b1 to 9.5, moving from beta channels to the official channels
  • Also updated the other packages to their latest versions
  • Added an install_requirements.sh script to make it easier for me to update to newer versions of packages
  • Expanded on the CONTRIBUTING.md document in order to facilitate new GitHub users
  • Made minor changes to Mechanics/Images
  • Fixed links
  • Minor change to Points and Scores
  • Added Exported Local images to the Images section
  • Specified year in the Introduction
  • Corrected word in the Introduction
  • Added to TODO
  • Fixed cache not working (inefficient build times before now, damn :/)
    • Improved build times by ~0-30s, which is about a 33% improvement
  • Minor fix to Words
  • Added Dynamic Background stuff in the reference
  • Updated Modded Viewer to allow <div>s now
  • Add to the Reference
  • Got rid of the manual author insertion, as the new mkdocs-material seems to do that for you
  • Tidied up the progress indicator section by removing the bytes example and adding a tip for clarification
  • Added more to the Git CLI tutorial for clarification on where to run the commands
  • Added Tools section to the Resources page
  • Added AvifCyoaCompressor and InteractiveCyoaVerifier to Tools
  • Added Lt Ouroumov's modded creator to tools
  • Added clarification of the order of Word IDs and Point IDs when displaying points
  • Added an alternative indicator to the extending your cyoa section
  • Added mention of Lt Ouroumov's viewer in the Viewer download section
  • Added ICC+ to resources, and copied Lt Ouromov's creator and the ICC+ to the very front page.
  • Added mirrors to the two additional viewers in the static folder.
  • Removed release date-time and word count for the latest version of the ICCT.
  • Removed Javascript from the Reference section as there is nothing there for now
  • Cleaned up the Reference so that only the easiest methods for doing something are included
  • Linked to a hex code colour picker in the Reference
  • Added PNG-MAN's tutorial for playing CYOAs offline to the tutorial
  • Removed reference to launchcode01dl's modded CYOAs, as they have taken it down.
  • Added information about pressing S to search in the Introduction
  • Added IntCyoaAutosaver to the tools list and added synergy with RegExp Download Organizer
  • Added mobile browser errors to the Troubleshooting page, and referenced it in the Extending Your CYOA page
  • Explicit mention of how to import CSS through files
  • Updated code for the mobile fix
  • Added links to more OCR programs
  • Removed launchcode01dl's modded CYOAs from the Resources page
  • Added cyoadip tool
  • Added instructions to the upload section (particularly Neocities) that clarifies that the Viewer should be extracted, and that a program like 7zip or WinRar for Windows is recommended
  • Removed informal language in the Resources page
  • Moved CYOA 101 to the top of the tutorials list
  • Removed mention of some drama in favour of a neutral point of view
  • Removed the CYOA Dropbox from Tools, as it has been deleted
  • Removed r/allsync_mirror as it has been banned
  • Added a disclaimer about AvifCyoaCompressor
  • Changed serve.sh to work
  • Minor fixes

Download the source code

v0.17.0

Released on 2023-08-08 at 04:03:17 UTC

Words: 29,814

Reading Time: 2 hours, 11 mins, 10 secs

  • Started work on and finished the Backgrounds section
  • Added and modified GitHub with fixes, as well as adding a reset section
  • Changed Github to GitHub in the navigation
  • Small fix in README.md
  • Spelling correction in Buttons and Variables
  • Fixed Buttons and Variables talking about Images at the Reference message at the end
  • Compressed 7 more gifs
  • Updated static directory index
  • Grammar and spelling checked
  • Added DnD style skill check in Reference
  • Added some more stuff to the Reference
  • Added .vscode/extensions.json in order to recommend extensions that are both:
    1. Compatible with .vscode/settings.json, and
    2. Help with writing and contributing to this project
      • Spell-checker added
  • Preemptively added docs/styling/backgrounds.md because I have some ideas
  • Added some more TODOs to the Reference
  • Added reddit_post.md, the Markdown for the (future) Reddit post in the /static folder
  • Added a Download tutorial for offline use button so that people didn't have to visit the website
  • Added icons to the buttons in the index.md page
  • Changed icons for dark and light mode toggles in order to be more clear about what the buttons do
  • Added some scripts to help with virtual environments on Linux
  • Updated Resources page
  • Moved the About/Licence section down to the very bottom
  • Fixed a relative link in the Introduction
  • Deleted old _copyright.html partial that wasn't in use
  • Removed "made by" section for static_background.css
  • Add Moirai Interactive to CYOA Creators list
  • Added link to archived Miraheze ICCT
  • Added (WIP) markers to chapters in preparation of Reddit release
  • Added image_downloader_fix.js to the Static folder
  • Swapped position of "Get a list of Point Types" and "Change how many points I have" in the Reference
  • Add <strong> and <em> tags to the HTML section of the Reference, though it is not explicitly stated that they should be preferred due to semantics. Also there is no strong and emphasized example.
  • Add links to the Modded Viewer from the HTML and CSS sections of the Reference

Download the source code

v0.16.0

Released on 2023-07-21 at 07:27:04 UTC

Words: 26,436

Reading Time: 1 hour, 56 mins, 58 secs

  • Started on and finished the GitHub page
  • Actually swapped Neocities and GitHub in the nav this time
  • Expanded on the Publishing section of the TODO section
  • Removed casual speech from Words and fixed a minor typo
  • Added a modded css Viewer file that changes the Point Bar icon colours
  • Beautified the fixed app.js and chunks-vendor.css files because it makes them easier to work with and only adds a negligible increase in space
  • Got rid of unneeded dev-requirements.txt, get_reading_time.py, and enter_venv.ps1 files
  • Added docs/images/bin folder for other images I want to ignore, and moved the favicon in there
  • Moved workflow to Linux
  • Decided that version release times will be based on Git logs of the last commit from now on
  • Other minor fixes

Download the source code

v0.15.0

Released on 2023-07-20 at 08:10:12 UTC

Words: 23,390

Reading Time: 1 hour, 43 mins, 13 secs

  • Started work on and finished the Neocities page
  • Finished Static page as it was incomplete
  • Added to Design page
  • Changed the licence of all content to the CC0 Public Domain licence
  • Moved Licence section in the About page up above TODO and Changelog
  • Put TODO under the Roadmap section, and separated TODO into TODO and Completed to better get rid of unneeded text
  • Added a video tutorial to Backpack and Choice Import which helps the Static publishing page
  • Added a lot to the Reference
  • Updated lots of other sections
  • Added Choice Copying that undoubtedly would have been in the lost Copying section
  • Changed README.md to talk about why https://icctutorial.pages.dev is the preferable URL
  • Added abbreviations for Cf. and cf.
  • Added to the Reference
  • Added a requirements.txt file so that it's easier to self-host this website
  • Upgraded mkdocs-material from 9.2.0b0 to 9.2.0b1
  • Changed GitHub actions workflow to use requirements.txt
  • Compressed gifs once more
  • Deleted mkdocs-material folder that I hosted locally, now that requirements.txt would make it defunct
  • Deleted venvold/, another local folder
  • Moved all of the top-level scripts into the scripts/ directory for organizational purposes
  • Made a new cross-platform word count python script
  • Realized that the old word count script was counting EVERYTHING in the root directory, including docs belonging to venv and mkdocs-material. Rerunning it only within docs/ changed the total from 121,255 (0.14.0) to 21,359 (whilst developing 0.15.0). It appears I had vastly overestimated my word count.
  • Finally deleted the old/ directory
  • Spelling corrections
  • Moved the Authors field from below the comments section to above it, in line with the "Last update" and "Created" metadata.
  • Fixed some dead links
  • Updated Words fields on the About page with the more accurate amount of plaintext words typed (as opposed to all words counting the Markdown)
  • Added word count for v0.12.0 and below
  • Updated Introduction#Sharing, introducing a new sharing tip
  • Added an Archive to the Resources section
  • Reordered Troubleshooting text
  • Added mkdocs-macros-plugin to the codebase, allowing for arbitrary insertion of macros for easier coding
  • Made a youtube_embed() macro to make it easier to embed YouTube videos
  • Change requirements.txt such that it now allows semantic versioning upgrades. Not sure if all packages use semantic versioning though
  • Officially implemented Reading Time under Releases, using macros
  • Swapped Neocities and GitHub positions because of two reasons:
    1. Complex topics should come last, and
    2. More people would probably be comfortable using Neocities
  • Modified count_words.py since I no longer need it to ask for input

Download the source code

Content released under here is licensed under CC BY-SA 4.0.

v0.14.0

Released on 2023-07-17 at 05:13:53 UTC

Words: 24,023

  • Added and finished the Style Templates section
  • Added and finished the Creating Your CYOA section
  • Added a note to Words
  • Added the ICC comments section to the Resources section
  • Moved Extending Your CYOA section above Publishing, as publishing should be the last thing you do
  • Added PS script to automatically enter into the virtual environment

Download the source code

v0.13.2

Released on 2023-07-13 at 12:41:52 UTC

Words: 22,496

  • Fixed Words stat on About page
  • Fixed minor Mechanics TOC issue
  • Rewritten a small portion of Buttons & Variables
  • Fixed Backpack and Choice Import reference sentence referring to "Defaults" instead

Download the source code

v0.13.1

Released on 2023-07-13 at 12:09:14 UTC

Words: 22,456

  • Added more Resources
  • Changed links in the Introduction to be less intrusive
  • Added more limitations in the Introduction
  • Minor CONTRIBUTING fix
  • Fixed Mechanics section not having removed TODO sections
  • Miscellaneous changes

Download the source code

v0.13.0

Released on 2023-07-13 at 11:40:35 UTC

Words: 22,475

  • FINISHED MECHANICS SECTION!!!
  • Finished Groups page's first revision
  • Compressed gifs using script again
  • Moved Backpack and Choice Import page from the bottom of Mechanics to underneath Addons, as it's a more elementary concept
  • Updated README.md to include instructions on building from a Release
  • Added Mermaid graphs in IDs and Requirements
  • Added more Resources
  • Added a project-wide word count script for Linux (not my code)
  • Miscellaneous additions

Download the source code

v0.12.0

Released on 2023-07-13 at 05:17:40 UTC

Words: 21,918

  • Finished first revision of the Backpack and Choices Import page
  • Changed Buttons to Buttons and Variables
  • Modified Buttons a bit
  • Re-edited the Publishing page, though it's still not yet complete
  • Miscellaneous stuff

Download the source code

v0.11.0

Released on 2023-07-13 at 03:57:16 UTC

Words: 21,304

  • Added Buttons page's first revision
  • Added more examples (or TODO examples) to the Reference. I expect examples or pictures for every single entry there by v1.0.0
  • Moved Allowed HTML tags, Allowed Attributes, and Allowed Styles into the Reference section
  • Added Icons to each page title in the Navigation Bar
  • Found a new tutorial that has a lot of stuff to add
  • Compressed all gifs, saving 110 MB / 28.8% of space (script in repo)
  • Added UTC to the last two releases' dates
  • Changed Purpose to Background and expanded on it in the Introduction
  • Using privacy-friendly stats now
  • Split Background into Rationale and Background in the About menu
  • Added at to the previous release date
  • Deleted old _main.html template that was useless
  • Added some abbreviations
  • Added more to the Styling
  • Created a Colours page, that is of yet still unfinished (will finish after Styling section is finished)
  • Fixed miscellaneous stat bug (I think)
  • Miscellaneous additions and fixes

Download the source code

v0.10.0

Released on 2023-07-10 at 11:59:17 UTC

Words: 18,641

  • Finished the first revision of the Extending Your CYOA section
  • Added some abbreviations

Download the source code

v0.9.0

Released on 2023-07-10 at 07:09:35 UTC

Words: 17,248

  • Added and finished Words section
  • Ticked Addons of the TODO because I'm dumb
  • Added Addons as completed on the Mechanics index
  • Fixed my release dates not following the YYYY-MM-DD format
  • Deleted Copying section, will be adding to Rows
  • Added missing functionality to Rows section, adding links to main pages
  • Realized I had skipped some Object functions purely because I was going to address them in their other sections. So I made a title and linked them to where they are actually hosted.
  • Moved a whole section of the Words tutorial to the Reference
  • Added Web Programming resources in Resources
  • Added a bit to the Reference
  • Finished Static Background section
  • Fixed some dead links (have to get a tool to check for that)

Download the source code

v0.8.0

Released on 2023-07-10 at 00:47:05 UTC

Words: 15,387

  • Finished the Addons section
  • Fixed the "Last update" not working as intended
  • Fixed missing Viewer file
  • Reordered Mechanics section in TODO
  • Added authors section down the bottom, which will show the contributor percentage if there is more than one author.
  • Changed Reference text to make more sense
  • Miscellaneous fixes

Download the source code

v0.7.0

Released on 2023-07-09 at 11:40:35 UTC

Words: 15,343

  • Finished the first revision of the Defaults section
  • Miscellaneous fixes

Download the source code

v0.6.1

Released on 2023-07-09 at 11:21:29 UTC

Words: 15,064

  • Finished first revision of the Image section
  • Added the Troubleshooting section on the official TODO, made a start on it
  • Moved Reference, About, and Troubleshooting pages into the Appendix
  • Added (TODO) and (WIP) prefixes to the Reference
  • Added Sharing section back to the Introduction
  • Moved the TODO from the README.md to the About page
  • Added Resources section.
  • Enabled Task Lists for the TODO section
  • Added the Design section under Styling
  • Fixed a few bad links
  • Minor typograpgical fixes

What happened to v0.6.0? I forgot to push my changes before making a release :P

Download the source code

v0.5.1

Released on 2023-07-07 at 09:11:38 UTC

Words: 11,664

  • Finally completed the IDs and Requirements section
  • Enabled comments for the Points and Scores section
  • Updated Mechanics's Table of Contents
  • Added a script loop_serve.ps1 because mkdocs kept crashing when I moved files while it was building the site

Download the source code

v0.5.0

Released on 2023-07-07 at 07:55:19 UTC

Words: 11,264

  • Added Points & Scores section, finished first revision
  • Changed Objects section title from "Objects" to "Objects / Choices"
  • Realized that I had not, in fact, finished IDs and Requirements
    • Updated headings but have not finished filling it out
  • Added code block copying functionality

Download the source code

v0.4.0

Released on 2023-07-07 at 05:12:04 UTC

Words: 10,165

  • Finished IDs and Requirements section
  • Fixed Mechanics' TOC
  • Added previous version's information here
  • Created Basics section and separated the Introduction/Preface from it
  • Added links to the Reference section at the bottom of each section
  • Adjusted CONTRIBUTING.md
  • Other miscellaneous changes

Download the source code

v0.3.1

Released on 2023-07-07 at 02:07:22 UTC

Words: 9,756

  • Created a CONTRIBUTING.md so contributors know what they need to
  • Switched from AGPLv3 for the entire project to AGPLv3 for the source only, and CC BY-SA 4.0 for the content
  • Added massive TODO check list in the README.MD
  • Added building instructions
  • Added an About page with information on the tutorial itself
  • Added comment sections to all pages, not just the very front page
  • Added a lot of images to the IDs & Requirements sections, with it nearly being done
  • Added a table of contents to the Mechanics section, I'll do it to all places from now on
  • Did a lot of work to the Publishing section
  • Filled in a lot of the Reference section
  • Updated abbreviations list
  • Updated Manual of Style to include time and date formats

Download the source code

Content released under here is licensed under the AGPLv3 licence.

v0.3.0

Released on 2022-06-17 at 19:48:21 UTC

Words: 5,844

  • Added first revision of the Objects page
  • Tidied up previous stuff

Download the source code

v0.2.0

Released on 2022-06-17 at 17:37:11 UTC

Words: 5,199

  • Finished first revision of the Rows page
  • Updated previous Introduction and other miscellaneous changes

Download the source code

v0.1.0

Released on 2022-06-17 at 13:40:35 UTC

Words: 4,003

  • Initial release
  • Completed first revision of the Introduction section

Download the source code

Licence

This site is dual-licensed under the AGPLv3 and CC0 1.0 licences.

Content

All original content (text, images, etc) in this tutorial is licensed under the CC0 1.0 Universal Public Domain Dedication licence.

Content in this instance is defined as any text located within the docs/ directory, both how it is rendered in the website and how it exists within source files as plaintext. The formatting markup for Markdown belongs to the Source Code licence. This means you can freely copy text from this website, but you cannot freely copy the text along with the Markdown.

No Copyright

The person who associated a work with this deed has dedicated the work to the public domain by waiving all of his or her rights to the work worldwide under copyright law, including all related and neighboring rights, to the extent allowed by law.

You can copy, modify, distribute and perform the work, even for commercial purposes, all without asking permission.

  • In no way are the patent or trademark rights of any person affected by CC0, nor are the rights that other persons may have in the work or in how the work is used, such as publicity or privacy rights.
  • Unless expressly stated otherwise, the person who associated a work with this deed makes no warranties about the work, and disclaims liability for all uses of the work, to the fullest extent permitted by applicable law.
  • When using or citing the work, you should not imply endorsement by the author or the affirmer.

To summarize:

  • Permissions:
    • Commercial use: The licensed material and derivatives may be used for commerical purposes.
    • Distribution: The licensed material may be distributed.
    • Modification: The licensed material may be modified.
    • Private use: The licensed material may be used and modified in private.
  • Limitations:
    • Liability: This licence includes a limitation of liability.
    • Patent use: This licence explicitly states that it does NOT grant any rights in the patents of contributors.
    • Trademark use: This licence explicitly states that it does NOT grant trademark rights, even though licences without such a statement probably do not grant any implicit trademark rights.
    • Warranty: This licence explicitly states that it does NOT provide any warranty.

Source Code

The source code for this tutorial is licensed under the AGPLv3 licence (unless stated otherwise in the source).

To summarize:

  • Permissions:
    • Commercial use: The licensed material and derivatives may be used for commerical purposes.
    • Distribution: The licensed material may be distributed.
    • Modification: The licensed material may be modified.
    • Patent use: This licence provides an express grant of patent rights from contributors.
    • Private use: The licensed material may be used and modified in private.
  • Conditions:
    • Disclose source: Source code must be made available when the licensed material is distributed.
    • License and copyright notice: A copy of the licence and copyright notice must be included with the licensed material.
    • Network use is distribution: Users who interact with the licensed material via network are given the right to receive a copy of the source code.
    • Same licence: Modifications must be released under the same licence when distributing the licensed material. In some cases a similar or related licence may be used.
    • State changes: Changes made to the licensed material must be documented.
  • Limitations:
    • Liability: This licence includes a limitation of liability.
    • Warranty: This licence explicitly states that it does NOT provide any warranty.

Comments

If you have any questions, concerns, corrections, or anything else, please comment below.