@jaxzhou/dsh-file-explorer 0.1.7 → 0.1.8

package/README.md

@@ -55,7 +55,7 @@ The right pane picks each tab's body from the file:
 | **Source code** | Syntax highlighting, line numbers, and a copy button for 24 grammars: TypeScript/JavaScript, shell, Python, Ruby, Go, Rust, Java, C, C++, C#, Kotlin, Swift, PHP, YAML, TOML, INI, HTML, CSS, SCSS, Less, SQL, XML, Lua, MDX |
 | **Images** | PNG, JPEG, GIF, WebP, AVIF, BMP, ICO and SVG, drawn to the pane. An SVG goes through `<img>`, so its scripts never run |
 | **PDF** | Drawn by the browser's own PDF reader, from the file's bytes — so its text is real text |
-| **Word, Excel, PowerPoint** | `.docx`, `.xlsx` and `.pptx` unpacked in the page: a document's headings, lists, tables, pictures and code; a workbook's sheets as a grid, with the dates it stores as numbers shown as dates; a deck's slides as an outline of their text and pictures |
+| **Word, Excel, PowerPoint** | `.docx`, `.xlsx` and `.pptx` unpacked in the page: a document's headings, lists, quotes, tables, pictures and code, with each run's basic formatting — bold, italic, underline, strikethrough, super- and subscript, colour, highlight — and a paragraph's alignment; a workbook's sheets as a grid, with the dates it stores as numbers shown as dates; a deck's slides as an outline of their text and pictures |
 | **Anything else** | Numbered plain text — an unmapped suffix (`.vue`, `.proto`, `.txt`) stays plain rather than guessing a wrong grammar. The legacy binary Office formats (`.doc`, `.xls`, `.ppt`) are not previewed: the pane says so and offers the download |
 
 A **Mermaid** code fence (` ```mermaid `) is a diagram, not source, so the pane
@@ -82,6 +82,9 @@ others alone.
 Every text body carries **Copy**, which copies the file's own text — a rendered
 Markdown document copies its Markdown source.
 
+Every control in the pane is an icon rather than a word: its tooltip and its
+accessible label name it, and a toggle states itself by its fill.
+
 A rendered Markdown or HTML document adds two rows to that menu — **PDF** and
 **Word** — and each **downloads a file directly**, with no print dialog:
 
@@ -199,11 +202,14 @@ restart the profile.
   diagram types Mermaid 11 carries; a malformed one keeps its source and names
   the failure above it.
 - **An Office preview is content, not layout.** A `.docx` shows its headings,
-  text, lists, tables and pictures; a `.xlsx` shows its cells' values; a `.pptx`
+  lists, quotes, tables and pictures, and the basic formatting its runs carry —
+  bold, italic, underline, strikethrough, super- and subscript, colour, highlight
+  — with each paragraph's alignment. A `.xlsx` shows its cells' values; a `.pptx`
   shows each slide's text and pictures. What is *not* there is everything that
-  needs a layout engine and the fonts the file names: colours and themes, column
-  widths, page breaks, headers and footers, charts, SmartArt, and animations.
-  Formulas show the value the file cached, not a recalculation.
+  needs a layout engine and the fonts the file names: font faces and sizes,
+  spacing and indents, columns and page breaks, headers and footers, table
+  borders and shading, charts, SmartArt, and animations. Formulas show the value
+  the file cached, not a recalculation.
 - **Only the OOXML formats are read.** `.doc`, `.xls` and `.ppt` are the older
   binary container, which this pane does not parse — it says so and offers the
   download instead.

package/README.zh.md

@@ -49,7 +49,7 @@ dsh --profile web
 | **源码** | 24 种语法的语法高亮、行号与复制按钮：TypeScript/JavaScript、shell、Python、Ruby、Go、Rust、Java、C、C++、C#、Kotlin、Swift、PHP、YAML、TOML、INI、HTML、CSS、SCSS、Less、SQL、XML、Lua、MDX |
 | **图片** | PNG、JPEG、GIF、WebP、AVIF、BMP、ICO、SVG，自动适配窗格。SVG 经 `<img>` 绘制，其中的脚本不会执行 |
 | **PDF** | 交由浏览器自带的 PDF 阅读器绘制，用的是文件自身的字节 —— 因此其中的文字是真文字 |
-| **Word / Excel / PowerPoint** | `.docx`、`.xlsx`、`.pptx` 在页面内解包：文档的标题、列表、表格、图片与代码；工作簿按工作表显示为网格，并以日期显示它按数字存储的日期；演示文稿按幻灯片显示其文字与图片的提纲 |
+| **Word / Excel / PowerPoint** | `.docx`、`.xlsx`、`.pptx` 在页面内解包：文档的标题、列表、引用、表格、图片与代码，并保留每段文字的基础格式——粗体、斜体、下划线、删除线、上/下标、颜色、高亮——以及段落的对齐方式；工作簿按工作表显示为网格，并以日期显示它按数字存储的日期；演示文稿按幻灯片显示其文字与图片的提纲 |
 | **其它** | 带行号的纯文本 —— 未映射的后缀（`.vue`、`.proto`、`.txt`）保持纯文本，而不是猜测一个错误的高亮。旧版二进制 Office 格式（`.doc`、`.xls`、`.ppt`）不做预览：窗格会说明原因并提供下载 |
 
 **Mermaid** 代码围栏（` ```mermaid `）是图表而不是源码，窗格会把它画出来：
@@ -69,6 +69,9 @@ dsh --profile web
 每一种文本预览还有 **复制**，复制的是文件自身的文本——渲染态的 Markdown 复制的是它的
 Markdown 源码。
 
+窗格里的每个控件都是图标而不是文字：名称由悬浮提示与无障碍标签给出，开关状态由填充
+色表示。
+
 渲染态的 Markdown 与 HTML 会在该菜单里再加两行 —— **PDF** 与 **Word** ——
 各自 **直接下载文件**（不走打印对话框）：
 
@@ -170,10 +173,11 @@ profile。
   其中的标签不可选中，且始终以白底绘制：PDF 页面与 Word 文档都是白底，为深色窗格
   绘制的图在它们上面会看不见。绘制范围是 Mermaid 11 支持的图表类型；语法错误的
   图表会保留源码，并在上方说明失败原因。
-- **Office 预览是内容，不是排版**：`.docx` 显示标题、正文、列表、表格与图片；
-  `.xlsx` 显示单元格的值；`.pptx` 显示每页的文字与图片。**没有**的是所有需要排版
-  引擎和文件所指定字体的东西：颜色与主题、列宽、分页、页眉页脚、图表、SmartArt、
-  动画。公式显示文件缓存的值，不做重算。
+- **Office 预览是内容，不是排版**：`.docx` 显示标题、列表、引用、表格、图片，以及每段
+  文字的基础格式——粗体、斜体、下划线、删除线、上/下标、颜色、高亮——和段落的对齐
+  方式；`.xlsx` 显示单元格的值；`.pptx` 显示每页的文字与图片。**没有**的是所有需要
+  排版引擎和文件所指定字体的东西：字体与字号、行距与缩进、分栏与分页、页眉页脚、
+  表格边框与底纹、图表、SmartArt、动画。公式显示文件缓存的值，不做重算。
 - **只读取 OOXML 格式**：`.doc`、`.xls`、`.ppt` 是更早的二进制容器，本窗格不解析
   —— 会说明这一点并提供下载。
 - **预览受「完整读取」上限约束**：官方 Web 组合默认 32 MiB，超过的 PDF 或 Office