sync: update from private repo (6fcb0d0)
This commit is contained in:
oss-sync
+42
-1
@@ -65,12 +65,53 @@ ReadPdf({ path: "input/spec.pdf", query: "第\\d+条", query_mode: "regex" })
|
||||
### ReadExcel
|
||||
|
||||
```js
|
||||
ReadExcel({ file_path: "input/data.xlsx" })
|
||||
ReadExcel({ path: "input/data.xlsx" })
|
||||
// → 全シートのセル内容をテキスト形式で返す
|
||||
```
|
||||
|
||||
巨大な Excel は token を食うので、シートを絞る場合は SplitExcelSheets を使う。
|
||||
|
||||
#### include_styles — セル装飾の取得（オプション）
|
||||
|
||||
```js
|
||||
ReadExcel({ path: "input/report.xlsx", include_styles: true })
|
||||
// → 値テーブルの後に ### Styles セクションが追記される
|
||||
```
|
||||
|
||||
デフォルトは `false`（後方互換）。`include_styles: true` を指定すると、値テーブルの直後に各シートの `### Styles` セクションが出力される。
|
||||
|
||||
**出力形式 — dedup legend + range map:**
|
||||
|
||||
```
|
||||
### Styles — Sheet1
|
||||
s1 = fill:#FFF2CC;font:bold
|
||||
s2 = border:top(thin),bottom(double,#808080);numFmt:"0.00%"
|
||||
|
||||
s1: A1:D1,A5:D5
|
||||
s2: B2
|
||||
merges: B2:D4
|
||||
```
|
||||
|
||||
- **legend**: スタイル ID (`s1`, `s2`, ...) とそのシグネチャを列挙。シグネチャは `fill` / `font` / `border` / `numFmt` / `align` のうち非デフォルト部分を `;` 区切りで結合した文字列。
|
||||
- **range map**: 同一スタイルを持つセルを矩形にまとめて `A1:D3` 形式で列挙。単一セルは `A1`。
|
||||
- **merges**: 結合セル範囲の一覧（`ws.model.merges` から取得）。
|
||||
- **conditionalFormatting**: 条件付き書式が存在する場合 `present (effective styles not evaluated)` と表示（実際の表示色は評価しない）。
|
||||
- **装飾のみ・値なしセルも捕捉**: スタイルスキャンは `includeEmpty:true` で実行するため、値がなく書式だけ設定されたセルも対象に含まれる。
|
||||
- **`sheet`/`range` フィルタを尊重**: `include_styles` は値テーブルと同じ `sheet`/`range` フィルタでスキャン範囲を限定する。指定した範囲外のセルのスタイルと、範囲に交差しない結合セルは結果に含まれない。
|
||||
- **デフォルト色の省略**: デフォルト色 (theme index 1 = 通常黒) に明示設定したフォント色はデフォルト扱いで省略される。同様に border の theme index 0（自動色）も省略される。
|
||||
|
||||
**テーマカラーの解決（ベストエフォート）:**
|
||||
|
||||
テーマカラーはファイルの `theme1.xml` から読み取り、OOXML の lt/dk スワップを適用して `#RRGGBB` に解決する。解決できた場合は `theme(N,resolved=#RRGGBB)` の形式で表示し、`resolved=` は近似値であることに注意。テーマ XML が解析できない場合は `theme(N,tint=T)` のように生の参照のまま出力する。
|
||||
|
||||
**max_style_ranges — range 数の上限:**
|
||||
|
||||
`max_style_ranges`（デフォルト 250）で全シートを通じた range 出力数を制限する。上限に達した場合は `[styles truncated: max_style_ranges=N reached]` を表示し、以降のスタイルは省略される。値テーブルが先に出力されるため、スタイルセクションがトークン上限で切り捨てられても値は失われない。
|
||||
|
||||
**編集には python + openpyxl を推奨:**
|
||||
|
||||
ReadExcel はスタイルを読むだけで、書き込みは行わない。既存スタイルを保持したまま値を編集する場合は `Bash` ツールで python + openpyxl を使うこと（openpyxl は触れていないセルのスタイルを保持する）。
|
||||
|
||||
### ReadDocx
|
||||
|
||||
```js
|
||||
|
||||
Reference in New Issue
Block a user