Style Settings presets · Compatibility matrix · Changelog
Owen Graphite v3.1.95 is a liquid-glass Obsidian theme for technical documentation, knowledge bases, and report-ready notes, giving Korean/English typography, long tables, code blocks, workspace chrome, Style Settings controls, and PDF export layouts one calm graphite surface across Live Preview, Reading View, and print.
No companion required: Owen Graphite keeps its Style Settings schema and English/Korean metadata inside the theme. Obsidian's locale selects the native setting labels. Persistent code-title editing is an optional Owen Editor 0.6.28 feature, separate from theme configuration.
| Workflow | What you feel immediately |
|---|---|
| Long technical notes | CJK/Latin paragraphs, headings, code, and dense tables keep a stable rhythm without feeling cramped. |
| Live Preview writing | Editing, Reading View, and rendered widgets share the same quiet surfaces for tables, code blocks, callouts, and embeds. |
| Report and PDF handoff | Header/footer labels, page numbering, screen-first PDF readability, and page-break guards support recurring report delivery. |
| Daily workspace navigation | Tabs, file explorer hierarchy, search, settings, popovers, and type badges use a restrained graphite liquid-glass language. |
| Surface | Design signal | Function signal |
|---|---|---|
| Workspace chrome | Frosted white/graphite panels, shallow rims, and soft lift states | Active files, parent folders, tabs, and vault controls stay scannable in large vaults. |
| Writing surface | Calm document panes with balanced body, code, table, and callout density | Long Korean/English technical pages remain readable through editing and review. |
| Settings and presets | Compact glass controls instead of loud colored panels | Style Settings exposes PDF, typography, spacing, chrome, and accessibility options without visual clutter. |
| PDF export | Report labels, customer-delivery presets, and print-safe spacing | Notes can become screen-shared PDFs or formal report output with less manual cleanup. |
| Guard | Current status | Evidence |
|---|---|---|
| Bundle freshness | theme.css must match dist/theme-v3.css |
release plan |
| Zero-important cascade | declaration-level !important policy is enforced |
cascade research |
| Style Settings contract | option ids/defaults are audited against the contract | contract |
| Docs/assets links | local Markdown links and README images are audited | contributing |
| Live Preview/PDF parity | LP hit-routing, PDF header/footer, and visual fixture checks are scripted | release plan |
| Surface | Preview |
|---|---|
| Light mode |  |
| Dark mode |  |
| Top tabs and floating toolbar |  |
| Writing surface and floating toolbar |  |
| Style Settings report controls |  |
| PDF customer delivery visibility |  |
| Owen Editor toolbar controls |  |
| File explorer type badges |  |
New comparison screenshots should follow the visual comparison guide so default Obsidian and Owen Graphite are captured with the same note, viewport, and state.
| Item | Value |
|---|---|
| Version | 3.1.95 |
| Baseline / rollback target | v3.1.95 |
| Mode support | Light / Dark |
| Platform | Desktop & Mobile |
| Design policy | Liquid Glass core · token-first surfaces · zero-important cascade |
Light / Dark mode screenshots
Install the Style Settings plugin to unlock the report, typography, spacing, PDF, and workspace polish controls referenced below.
This release restores Owen Graphite's language selector when Obsidian is Korean but Style Settings cannot resolve its legacy locale key, and fills the new Interface heading's semantic icon tile.
| Area | What changed |
|---|---|
| Language selector | Automatic (Obsidian), Korean, and English preserve the existing ogd-language-* values. |
| Compatibility bridge | The optional localization companion translates only Owen Graphite rows and Style Settings chrome without modifying Style Settings data. |
| Interface icon | The Interface heading uses the existing semantic icon owner with an 18px Languages glyph and graphite light/dark ink. |
| Validation | Obsidian 1.12.7 runtime checks cover automatic fallback, explicit English/Korean classes, translated labels, and the computed icon mask. |
This release aligns Obsidian's core settings plus Owen Graphite, Owen Editor, and Owen Exporter with the same grouped-card language used by Owen Mermaid while keeping each function visually distinct.
| Area | What changed |
|---|---|
| Settings groups | Eight Obsidian core tabs plus Graphite, Editor, and Exporter use compact grouped cards with independent 32px icon tiles where native headings exist. |
| Semantic icons | Every section has a purpose-specific Lucide glyph and color instead of a repeated collapse chevron. |
| Ownership | Editor and Exporter expose stable semantic section hooks so the theme does not depend on child position. |
| Validation | Obsidian 1.12.7 runtime checks cover core card counts, icon uniqueness, clipping, overflow, row overlap, and section borders. |
This release makes dense settings easier to scan, removes animated row flicker, and aligns the default document width and heading hierarchy with technical writing workflows.
| Area | What changed |
|---|---|
| Settings surfaces | Section headings and ordinary rows use flat dividers instead of rounded glass cards or decorative rails. |
| Hover feedback | Rows switch to a neutral background immediately, without animated borders, outlines, shadows, blur, or lift. |
| Document rhythm | The 297mm default width now drives Obsidian's readable line width, with a clearer H1-H4 hierarchy and document title. |
| Validation | Live Obsidian pointer cycles, owner guards, Style Settings contracts, runtime evidence, and release gates are checked. |
Older feature notes are kept in dev/WIKI/DOCS/v3/feature-history.md.
- Open
Settings→Appearance→Manageunder Themes. - Search for
Owen Graphite. - Install and enable the theme.
Download Owen-Graphite-3.1.95.zip from the latest release, then extract it into your vault theme folder.
| Platform | Target path |
|---|---|
| Windows | <YourVault>\.obsidian\themes\Owen Graphite\ |
| macOS / Linux | <YourVault>/.obsidian/themes/Owen Graphite/ |
After extraction, open Obsidian and select Owen Graphite from Settings → Appearance → Themes.
Release assets also include GitHub's generated
Source code (zip). UseOwen-Graphite-3.1.95.zipfor the installable theme package.
If Obsidian is set to Korean but Style Settings still renders Owen Graphite in English, download Owen-Graphite-Companion-1.2.0.zip from the same release and extract its owen-graphite-style-settings-l10n folder into:
<YourVault>/.obsidian/plugins/owen-graphite-style-settings-l10n/
Reload Obsidian, enable Owen Graphite Companion under Community plugins, then choose Settings → Style Settings → Owen Graphite → Interface → Language. The bridge handles localization only and leaves Style Settings data.json unchanged.
The localization companion does not edit Markdown. To edit fenced code-block titles directly in Live Preview or Reading View, install Owen Editor 0.6.28 or later. Owen Editor stores the title in Markdown:
```bash title="Package update"
winget upgrade
```
```
### Option C — Git Install Or Update
Clone into `.obsidian/themes/Owen Graphite/`. Running the same command again updates the theme.
#### Windows (PowerShell)
```powershell
$ErrorActionPreference = "Stop"
$Vault = "D:\Path\To\YourVault" # replace with your vault path
$Repo = "https://github.com/towishy/Owen-Graphite.git"
$ThemesDir = Join-Path $Vault ".obsidian\themes"
$ThemeDir = Join-Path $ThemesDir "Owen Graphite"
New-Item -ItemType Directory -Force -Path $ThemesDir | Out-Null
if (Test-Path -LiteralPath (Join-Path $ThemeDir ".git")) {
git -C "$ThemeDir" fetch --quiet origin main
git -C "$ThemeDir" reset --quiet --hard origin/main
git -C "$ThemeDir" clean -qfd
Write-Host "OK: Owen Graphite updated."
} elseif (Test-Path -LiteralPath $ThemeDir) {
$Backup = "${ThemeDir}.backup-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
Move-Item -LiteralPath $ThemeDir -Destination $Backup
git clone --quiet $Repo "$ThemeDir"
Write-Host "OK: Owen Graphite reinstalled. Backup: $Backup"
} else {
git clone --quiet $Repo "$ThemeDir"
Write-Host "OK: Owen Graphite installed."
}
```
#### macOS / Linux (bash)
```bash
set -e
VAULT="/path/to/YourVault" # replace with your vault path
REPO="https://github.com/towishy/Owen-Graphite.git"
THEME_DIR="$VAULT/.obsidian/themes/Owen Graphite"
mkdir -p "$VAULT/.obsidian/themes"
if [ -d "$THEME_DIR/.git" ]; then
git -C "$THEME_DIR" fetch --quiet origin main
git -C "$THEME_DIR" reset --quiet --hard origin/main
git -C "$THEME_DIR" clean -qfd
echo "OK: Owen Graphite updated."
elif [ -e "$THEME_DIR" ]; then
BACKUP="$THEME_DIR.backup-$(date +%Y%m%d-%H%M%S)"
mv "$THEME_DIR" "$BACKUP"
git clone --quiet "$REPO" "$THEME_DIR"
echo "OK: Owen Graphite reinstalled. Backup: $BACKUP"
else
git clone --quiet "$REPO" "$THEME_DIR"
echo "OK: Owen Graphite installed."
fi
```
---
## 4. Developer Workflow
The v3 source lives in `src/` and is split into tokens, base, surfaces, chrome, features, themes, and plugins. Build and audit work should use the v3 tools in `dev/scripts/`.
| Task | Command |
| --- | --- |
| Build bundle | `python dev/scripts/bundle_v3.py` → `dist/theme-v3.css` |
| Refresh `theme.css` | `Copy-Item dist/theme-v3.css theme.css -Force` on Windows, or the equivalent copy command on macOS/Linux |
| Live Preview hit-routing audit | `python dev/scripts/audit_v3_hit_routing.py` |
| Duplicate selector audit | `python dev/scripts/v3_audit_duplicate_selectors.py` |
| Unused CSS candidate report | `python dev/scripts/build_unused_css_report.py` |
| Computed-style fingerprint capture | `python dev/scripts/capture_computed_fingerprint.py --build v3 --theme {light,dark}` |
| fingerprint diff | `python dev/scripts/fp_diff_summary.py [--theme dark]` |
| Release ZIP | `python dev/scripts/build_release.py` |
| Obsidian vault sync | `python dev/scripts/sync_obsidian_theme.py` |
See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution details, [CHANGELOG.md](CHANGELOG.md) for release history, and [dev/WIKI/DOCS/v3/design-spec.md](dev/WIKI/DOCS/v3/design-spec.md) for the design and validation contract.
---
## 5. Support
<p align="center">
<a href="https://github.com/sponsors/towishy">
<img src="screenshots/readme/sponsor-coffee.svg" alt="Support Owen Graphite with a coffee" width="560">
</a>
</p>
Owen Graphite is free and open source. If it helps your report, wiki, or documentation workflow, you can support maintenance through [GitHub Sponsors](https://github.com/sponsors/towishy).
---
## 6. License
MIT — [LICENSE](LICENSE)