Editing a wskill in the browser
§ 1Purpose
Use wcl wdoc serve --edit to modify units and blocks from the rendered book, writing real .wcl source.
§ 2Prerequisites
- The wskill renders (just wskill-check passes).
§ 3Flowchart
§ 4Steps
§ 4.11
§ 4.2Serve in edit mode
$ wcl wdoc serve wdoc/book/main.wcl --edit --comment
--edit injects the WYSIWYG client (it composes with --comment). Every edit writes real .wcl source through a validate-then-write pipeline — a change that would introduce schema errors rolls back.
§ 4.32
§ 4.4Edit units via the object editor
Every unit page carries an Edit this concept/entity/fact/process button that opens that exact object as raw WCL in the object editor. The editor also browses all schema objects by kind and namespace, and creates new ones from a schema template — new objects land in the right data file via the placement decorator, with the import wired automatically.
§ 4.53
§ 4.6Edit page blocks in place
Select any rendered block to edit its fields in the side panel, double-click text to edit it inline, and add / move / delete blocks. This is for page-level material; unit content is better edited through the object editor so it stays one unit in one file.
§ 4.74
§ 4.8Rebuild to apply
The server does not auto-rebuild: click the toolbar's Rebuild button (it rebuilds just the current page's sub-site and reloads) or press Enter in the server console for a full rebuild. Verify your change on the reloaded page.
Verification
The edited value appears in the data file (git diff shows a clean, minimal change) and on the reloaded page after rebuild.