Compare commits

...
Author SHA1 Message Date
cflmyandCursor 72777a8c74 Release v0.1.1: debug page Logo branding and packaging notes.
Bump crate version, use official Logo for marqdo debug favicon/brand, and document VS Code extension assets in the Windows release script.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-05 17:17:00 +08:00
4 changed files with 24 additions and 8 deletions

No files matched your search

+1 -1
View File
@@ -1,6 +1,6 @@
[package]
name = "marqdo"
version = "0.1.0"
version = "0.1.1"
edition = "2021"
license = "Apache-2.0"
description = "Marqdo — Markdown markers as an interpreted programming language"
+3 -2
View File
@@ -95,14 +95,15 @@ marqdo catalog public -o .marqdo
---
## 现状(v0.1.0)
## 现状(v0.1.1)
- 映射与解释器:Phase I 树遍历 + 字节码后端可用;金样例在 `tests/`
- **`marqdo view`**:文档浏览器(Structure + 函数大纲/搜索 + Execution + Source)
- **`marqdo debug`**:独立调试页(断点 / 单步 / locals;默认端口 7430)
- **`marqdo debug`**:独立调试页(断点 / 单步 / locals;默认端口 7430;页面 favicon / 品牌使用官方 Logo)
- **`marqdo catalog` / `sync`**:OKF 风格 YAML + 模块概念页
- 标准库:文本、文件、系统、时间、JSON、网络、数学(公式/绘图)、外联(Python 等)
- **用户静态站**:`public/` → `view output` → CI 发布 [gh-pages](https://cflmy.github.io/marqdo/)
- **VS Code 扩展**:分支 `vscode-extension`;Release 附带 `.vsix`(Run / View / Debug + CLI 安装助手)
- 选型:[ADR 0001 — Rust](doc/adr/0001-implementation-language.md)
```bash
+14 -4
View File
@@ -2,7 +2,7 @@
# to an existing GitHub Release tag.
# Usage (from repo root):
# powershell -File ./scripts/release-windows.ps1
# powershell -File ./scripts/release-windows.ps1 -Tag v0.1.0
# powershell -File ./scripts/release-windows.ps1 -Tag v0.1.1
param(
[string]$Tag = ""
)
@@ -79,26 +79,36 @@ $notes = @"
| ``$exeName`` | **Executable only** — does **not** include the standard library |
| ``$zipName`` | **Recommended**: ``marqdo.exe`` + ``lib/`` (place them together; ``lib/`` is resolved next to the binary) |
| ``$stdlibName`` | Standard library only (``lib/*.mq.md``) — unpack next to an existing ``marqdo.exe``, or set ``MARQDO_LIB`` |
| ``marqdo-0.0.5.vsix`` | **VS Code / Cursor extension** — syntax highlight, Run / View / Debug toolbar, CLI+stdlib install helper. Install via ``Extensions: Install from VSIX…``. Source: branch ``vscode-extension``. |
> **Important:** the standalone ``.exe`` does **not** ship ``lib/``. Importing ``lib/text.mq.md`` etc. needs the bundle zip or the stdlib zip beside the binary (or ``MARQDO_LIB``).
### Highlights
- Code as docs as knowledge: ``.mq.md`` is narrative + program
- ``marqdo debug``: breakpoints / step / locals; ``marqdo view`` stays docs-only
- View: function outline + search; wider layout
- ``marqdo debug``: breakpoints / step / locals; page favicon and brand use the official Logo
- ``marqdo view``: docs-only Structure + outline/search + Execution
- VS Code extension v0.0.5: three editor actions (Run / View / Debug), logo cover icon, startup CLI version & stdlib detection with optional install
- ``marqdo catalog`` / ``sync``: OKF-style YAML + module pages
- Roadmap: deeper OKF-aligned catalog for human–AI knowledge bases
### Quick start
``````text
marqdo --version
marqdo run public/00-welcome.mq.md
marqdo view public
marqdo debug public
marqdo catalog public -o .marqdo
``````
### Requirements
- Windows x64 for the prebuilt ``.exe`` / zip assets above
- Extension needs Marqdo CLI ≥ 0.1.0 (this release is 0.1.1); auto-install downloads the GitHub bundle when missing
"@
$body = @{
tag_name = $Tag
name = $Tag
name = "Marqdo $Tag"
body = $notes
draft = $false
prerelease = $false
+6 -1
View File
@@ -76,6 +76,7 @@ window.MARQDO_FILE_PATH = {path_js};
</script>
<header class="dbg-toolbar">
<div class="dbg-brand">
<img class="dbg-logo" src="https://s3.cflmy.cn/logo/Logo.png" width="20" height="20" alt="marqdo"/>
<span class="dbg-mark">marqdo</span>
<span class="dbg-mode">debug</span>
</div>
@@ -167,6 +168,9 @@ fn layout_debug(title: &str, main: &str) -> String {
<meta charset="utf-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>debug · {title} · marqdo</title>
<link rel="icon" href="https://s3.cflmy.cn/logo/Logo.ico" type="image/x-icon"/>
<link rel="shortcut icon" href="https://s3.cflmy.cn/logo/Logo.ico" type="image/x-icon"/>
<link rel="apple-touch-icon" href="https://s3.cflmy.cn/logo/Logo.png"/>
<style>{css}</style>
</head>
<body class="dbg-body">
@@ -225,7 +229,8 @@ html, body { margin: 0; height: 100%; }
border-bottom: 1px solid #000;
flex-shrink: 0;
}
.dbg-brand { display: flex; align-items: baseline; gap: 0.35rem; }
.dbg-brand { display: flex; align-items: center; gap: 0.4rem; }
.dbg-logo { display: block; border-radius: 3px; flex-shrink: 0; }
.dbg-mark { font-weight: 700; letter-spacing: -0.02em; color: #fff; font-size: 0.9rem; }
.dbg-mode {
font-size: 0.65rem;