mirror of
https://github.com/fluffos/fluffos
synced 2026-08-12 18:26:06 -04:00
c914f03d66
* docs: add local full-text search and a contributor README Add @easyops-cn/docusaurus-search-local to the Docusaurus site so the docs get an offline search bar (index built at build time, no external service). English and zh-CN pages are both indexed, and matched terms are highlighted on the target page. Add docs/README.md describing the Docusaurus setup, local dev/build commands, search behavior, directory layout, and gotchas; exclude it from the published site alongside CLAUDE.md. Point the root README's docs/ entry at it. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TSzcESzU9947zkGzQ6SMmE * docs: remove dead framework leftovers, fix index generation, complete the nav Delete the VitePress (.vitepress/) and Jekyll (_layouts/, css/) leftovers, the one-shot migration scripts (fix_md_header.py, fix_seealso.py), and the stale keywords.json snapshot; prune the matching .gitignore entries and docusaurus exclude patterns. Rewrite gen_index.py for Docusaurus: it emitted dead .html links and legacy 'layout: doc' frontmatter, choked on non-markdown entries, and dropped nested categories — regenerating an index would have broken it. It now emits the extension-less links the site actually uses, links nested category indexes (restoring apply/* on the zh-CN index), and refuses to run on the docs root. Fix update_index.sh's copy-paste titles (zh-CN efun/build were titled 'APPLY'), stop it clobbering the hand-written lpc/index.md, and cover cli/. Regenerated indexes pick up the missing driver/ffi-plan entry. add_missing_efuns.py now takes the keywords.json path as an argument instead of requiring a stale copy. Move CNAME and the Google site-verification file into static/ so they actually reach the published build output. Complete the sidebar: link the CLI category to cli/index and add the missing portbind/symbol/generate_keywords pages, and expose the previously orphaned stdlib section under Reference. Promote onBrokenLinks to 'throw' now the build is warning-free, and drop the empty Demo section from the landing page. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TSzcESzU9947zkGzQ6SMmE * docs: strip legacy 'layout: doc' frontmatter from all pages Mechanical sweep removing the Jekyll-era 'layout: doc' line from every doc page's frontmatter (Docusaurus ignores it), and the matching line from the templates in docs/CLAUDE.md so new pages don't reintroduce it. No content changes. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TSzcESzU9947zkGzQ6SMmE --------- Co-authored-by: Claude <noreply@anthropic.com>
78 lines
2.2 KiB
Markdown
78 lines
2.2 KiB
Markdown
---
|
|
title: master / parser_error_message
|
|
---
|
|
# parser_error_message
|
|
|
|
### NAME
|
|
|
|
parser_error_message - generate custom parser error messages
|
|
|
|
### SYNOPSIS
|
|
|
|
string parser_error_message(int error_type, object ob, ...) ;
|
|
|
|
### DESCRIPTION
|
|
|
|
This apply is called by the parser package when a parsing error occurs,
|
|
allowing the mudlib to provide custom error messages for parse_sentence()
|
|
failures.
|
|
|
|
**Arguments:**
|
|
- `error_type`: The type of parsing error that occurred
|
|
- `ob`: The object that caused the error (may be 0)
|
|
- Additional arguments depend on the error type
|
|
|
|
**Error Types and Arguments:**
|
|
|
|
- `ERR_IS_NOT` / `ERR_NOT_LIVING` / `ERR_NOT_ACCESSIBLE` (4 arguments):
|
|
- `string noun`: The noun that caused the error
|
|
- `int is_plural`: 1 if plural, 0 if singular
|
|
|
|
- `ERR_AMBIG` (3 arguments):
|
|
- `object *objects`: Array of ambiguous objects
|
|
|
|
- `ERR_ORDINAL` (3 arguments):
|
|
- `int ordinal`: The problematic ordinal number
|
|
|
|
- `ERR_THERE_IS_NO` (3 arguments):
|
|
- `string phrase`: The problematic word sequence
|
|
|
|
- `ERR_ALLOCATED` (3 arguments):
|
|
- `string message`: An allocated error string
|
|
|
|
- `ERR_BAD_MULTIPLE` (2 arguments):
|
|
- (no additional arguments)
|
|
|
|
- `ERR_MANY_PATHS` (5 arguments):
|
|
- (additional path-related data)
|
|
|
|
**Return Value:**
|
|
- Return a string containing the error message to show to the user
|
|
- Return 0 to use default error handling
|
|
|
|
### EXAMPLE
|
|
|
|
```c
|
|
string parser_error_message(int type, object ob, mixed arg) {
|
|
switch(type) {
|
|
case ERR_NOT_LIVING:
|
|
return "The " + arg + " is not alive.";
|
|
case ERR_AMBIG:
|
|
return "Which " + file_name(arg[0]) + " do you mean?";
|
|
case ERR_THERE_IS_NO:
|
|
return "I don't see any '" + arg + "' here.";
|
|
default:
|
|
return "I don't understand that.";
|
|
}
|
|
}
|
|
```
|
|
|
|
### SEE ALSO
|
|
|
|
parse_sentence(3), parse_init(3)
|
|
|
|
### NOTE
|
|
|
|
This apply requires the parser package to be enabled. Error type constants
|
|
should be defined in your mudlib's include files based on the parser
|
|
package implementation.
|