|
|
| Line 53: |
Line 53: |
|
| |
|
| ===BSL tutorials=== | | ===BSL tutorials=== |
| A project to document the built-in BSL commands is underway. This will replace the [[BSL:Functions]] and [[BSL:Variables]] pages with a more organized and natural system:
| | The revamp of the BSL docs that was planned here is on hold because the system we were using is too rickety and hacked together. The proper approach to interlinked pages that read from the same central pool of data is the [[mw:Extension:Semantic_MediaWiki|Semantic MediaWiki]] extension, so we'll focus on implementing that at some point in the future. --[[User:Iritscen|Iritscen]] ([[User talk:Iritscen|talk]]) 20:01, 18 March 2020 (CET) |
| # A single, master list of all functions and variables at [[BSL:List of built-in commands]] ("BSL:List" is a shortcut that redirects there). No longer will we have to browse two pages at once when we're trying to find a command but don't remember if it's a variable or function. The list is sortable by name, group, kind (function or variable), and platform availability, but does not contain any other info on the commands. It's just intended as a quick reference. You can click the group name for any command to go to the grouped page that discusses it in the context of related commands.
| |
| # Grouped pages which discuss all the functions/variables related to a certain task. This is where the detailed coverage of commands will be found. See [[BSL:AI activity]] for an example.
| |
| # Each command will also have its own page, so typing in the name of that command, e.g. "ai2_active", in the Go/Search box will take you to a page that allows you to either edit the basic information about that command or to visit its group's page.
| |
| | |
| The master list, the grouped pages, and the individual command pages are all dynamically interlinked (the system is explained [[BSL:Grouping|here]]). When I am done porting all commands to the new templates and creating all the grouped pages, BSL:List will automatically be completed, and the BSL:Functions and BSL:Variables pages will be replaced by messages that direct the reader to BSL:List and to the instructions for using functions/variables on [[BSL:Manual]].
| |
| | |
| I regret that the complex nature of the documentation system probably makes it feel difficult to contribute to, but it actually isn't as complicated as it seems, so if you would like to contribute, just let me know about any questions you have. --[[User:Iritscen|Iritscen]] ([[User talk:Iritscen|talk]]) 23:59, 11 May 2017 (CEST)
| |
| | |
| :Progress report: {{#expr:{{PAGESINCAT:BSL functions}}+{{PAGESINCAT:BSL variables}}}}/504 commands, {{PAGESINCAT:Scripting tasks}}/38 groups done.
| |
|
| |
|
| ===XML tutorials=== | | ===XML tutorials=== |