retoor
04e467e09b
- Add `wasm`, `wasm-clean`, and `install-emscripten` phony targets to Makefile for WebAssembly cross-compilation - Insert `WREN_PROFILE_ENTER`/`WREN_PROFILE_EXIT` macros in `wren_vm.h` and `wren_vm.c` to support optional runtime profiling via `WREN_PROFILE_ENABLED` - Create `example/os_demo.wren` demonstrating Platform, Process, and conditional exit usage - Update `example/regex_demo.wren` to import `Match` and exercise Match object properties, groups, and `matchAll` - Remove static HTML manual pages (`base64.html`, `dns.html`, `json.html`) and replace with structured `manual_src/` directory containing Jinja2 templates, YAML metadata, and content pages - Expand `README.md` with build targets table, manual building instructions, source layout, and guide for adding new module documentation
111 lines
5.1 KiB
HTML
111 lines
5.1 KiB
HTML
{# retoor <retoor@molodetz.nl> #}
|
|
{% extends 'page.html' %}
|
|
|
|
{% set page_title = "How-To Guides" %}
|
|
{% set breadcrumb = [{"title": "How-To Guides"}] %}
|
|
{% set prev_page = {"url": "tutorials/web-server.html", "title": "Web Server"} %}
|
|
{% set next_page = {"url": "howto/http-requests.html", "title": "HTTP Requests"} %}
|
|
|
|
{% block article %}
|
|
<h1>How-To Guides</h1>
|
|
|
|
<p>Quick, focused guides that show you how to accomplish specific tasks. Each guide provides working code examples you can copy and adapt for your projects.</p>
|
|
|
|
<div class="card-grid">
|
|
<div class="card">
|
|
<h3><a href="http-requests.html">Making HTTP Requests</a></h3>
|
|
<p>GET, POST, PUT, DELETE requests with headers, authentication, and error handling.</p>
|
|
<div class="card-meta">
|
|
<span class="tag">http</span>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="card">
|
|
<h3><a href="json-parsing.html">Working with JSON</a></h3>
|
|
<p>Parse JSON strings, access nested data, create JSON output, and handle errors.</p>
|
|
<div class="card-meta">
|
|
<span class="tag">json</span>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="card">
|
|
<h3><a href="regex-patterns.html">Using Regular Expressions</a></h3>
|
|
<p>Match, search, replace, and split text with regex patterns.</p>
|
|
<div class="card-meta">
|
|
<span class="tag">regex</span>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="card">
|
|
<h3><a href="file-operations.html">File Operations</a></h3>
|
|
<p>Read, write, copy, and delete files. Work with directories and paths.</p>
|
|
<div class="card-meta">
|
|
<span class="tag">io</span>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="card">
|
|
<h3><a href="async-operations.html">Async Programming</a></h3>
|
|
<p>Use fibers for concurrent operations, parallel requests, and timeouts.</p>
|
|
<div class="card-meta">
|
|
<span class="tag">fibers</span>
|
|
<span class="tag">scheduler</span>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="card">
|
|
<h3><a href="error-handling.html">Error Handling</a></h3>
|
|
<p>Catch errors with fibers, validate input, and handle edge cases gracefully.</p>
|
|
<div class="card-meta">
|
|
<span class="tag">fibers</span>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<h2>How-To vs Tutorials</h2>
|
|
|
|
<p><strong>Tutorials</strong> are learning-oriented. They walk you through building complete applications step by step, introducing concepts gradually.</p>
|
|
|
|
<p><strong>How-To Guides</strong> are goal-oriented. They assume you know the basics and need to accomplish a specific task quickly. Each guide focuses on one topic with copy-paste examples.</p>
|
|
|
|
<h2>Quick Reference</h2>
|
|
|
|
<table>
|
|
<tr>
|
|
<th>Task</th>
|
|
<th>Guide</th>
|
|
<th>Key Functions</th>
|
|
</tr>
|
|
<tr>
|
|
<td>Fetch data from API</td>
|
|
<td><a href="http-requests.html">HTTP Requests</a></td>
|
|
<td><code>Http.get()</code>, <code>response.json</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td>Parse JSON string</td>
|
|
<td><a href="json-parsing.html">JSON Parsing</a></td>
|
|
<td><code>Json.parse()</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td>Validate email format</td>
|
|
<td><a href="regex-patterns.html">Regex Patterns</a></td>
|
|
<td><code>Regex.new().test()</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td>Read file contents</td>
|
|
<td><a href="file-operations.html">File Operations</a></td>
|
|
<td><code>File.read()</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td>Run tasks in parallel</td>
|
|
<td><a href="async-operations.html">Async Operations</a></td>
|
|
<td><code>Fiber.new { }</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td>Handle runtime errors</td>
|
|
<td><a href="error-handling.html">Error Handling</a></td>
|
|
<td><code>fiber.try()</code></td>
|
|
</tr>
|
|
</table>
|
|
{% endblock %}
|