Creates an interactive, searchable, static web application for presenting Zig package documentation.
Has been upstreamed directly into the Zig project.
This project is now an archive.
While Firefox and Safari support are obviously required, I recommend Chromium for development for one reason in particular:
C/C++ DevTools Support (DWARF)
This makes debugging Zig WebAssembly code a breeze.
After making changes to src/ or lib/:
zig build
Use whatever local static file server you want to host the files:
cd zig-out
python -m http.server
Finally, create the tarball to serve as the input file, name it sources.tar,
and put it also into zig-out/. The system expects the top level of the
tarball to be the set of modules documented. So for the Zig standard library
you would do this: tar cf std.tar std/. Don't compress it; the idea is to
rely on HTTP compression.
I also suggest to omit test fixtures and test files. In other words, use the
set of files that zig installs to zig-out when you run zig build, which is
the same as the set of files that are provided on ziglang.org/download.
If the system doesn't find a file named "foo/root.zig" or "foo/foo.zig" it's going to use the first file in the tar as the module root, which is probably not what you want.
- when navigating back to search results, up+down arrow should keep working
- redundant search results (search "format")
- in query_exec_fallible, sorting should also check the local namespace inside the file
- walk assign_destructure not implemented yet
- escape URLs when rendering html (look for
missing_feature_url_escape) - implement renderHome for multiple modules
- struct fields: render each component separate rather than via source rendering
- infer comptime_int constants (example: members of
#std.time) - when global const has a type of
type, categorize it as a type despite its value- example:
std.DynLib(requires patching to add type annotation)
- example:
- show abbreviated doc comments in types and namespaces listings
- show type function names as e.g.
ArrayList(T) - enum fields should not be linkified (example:
std.log.Level) - shrink Ast to fit the slices
- linkification of methods (example:
std.array_hash_map.ArrayHashMap.count) - navigating to source from a decl should scroll to the decl
- in source view, make
@importsinto links, but keep same syntax highlighting - include struct field names and doc comments in search query matching
- include function parameter names and doc comments in search query matching
- instead of logging "can't index foo because it has syntax errors" put it in the UI
- in Walk.expr() it is missing support for asm_input/asm_output nodes
- in renderNamespace, handle an aliasing loop
- add a history item when clicking a search result (it already works when keyboard triggered)
- instead of "declaration not found", show the decl that can't be penetrated (example:
#std.os.system.fd_t)