Skip to content

Add macOS setup guide blog post - #7

Merged
pcodedynamics merged 1 commit into
mainfrom
cursor/blog-macos-setup-guide
Oct 5, 2026
Merged

pcodedynamics merged 1 commit into
mainfrom
cursor/blog-macos-setup-guide

Conversation

@pcodedynamics

@pcodedynamics pcodedynamics commented Oct 5, 2026 •

Copy link
Copy Markdown
Member

Summary

Adds a new blog post, "Bộ gõ tiếng Việt cho Mac: cài Funput trên macOS từng bước" (/blog/bo-go-tieng-viet-cho-mac/). The blog had dedicated guides for Windows, iOS, Android and Linux but none for macOS. This post fills that gap and targets the search query "bộ gõ tiếng Việt cho Mac".

What's in the post

  • System requirements: macOS 26 (Tahoe) or later, universal binary for Apple Silicon and Intel.
  • When to choose .pkg vs .app.zip, plus a SHA-256 checksum command.
  • Three setup steps: install, add Funput to Input Sources, then pick Telex / Telex nâng cao / VNI and test typing.
  • Finding Funput after install: the Spotlight entry app and the VI menu bar icon.
  • Useful features: tone placement, English restore, per-app VI/EN memory, text shortcuts, encoding conversion, config export.
  • The known Chromium/Electron input stall on macOS 26/27 beta, with workarounds.
  • Troubleshooting, updating, uninstalling, and an FAQ section.

UI paths and feature behavior were checked against the macOS app source (SettingsSidebar, AppLanguageMemory, KeyCombo), not just the docs. Two places where the docs disagree with the app were written to match the app: config export lives under Công cụ → Dữ liệu, and per-app memory is automatic rather than a setting. The privacy FAQ answer uses the same wording as /privacy/.

SEO

  • The primary keyword appears in title, seoTitle, description, the slug, the opening paragraph and the H2 headings.
  • H2/H3 hierarchy feeds the existing "Trong trang này" table of contents.
  • The screenshot uses descriptive alt text, explicit width/height and loading="lazy".
  • The post links to /macos/, /privacy/, related blog posts and the official docs.
  • Canonical URL, OG tags and Article JSON-LD come from the existing ReadingLayout.

Internal links

The new post now gets a link from each of these existing posts:

  • khong-go-duoc-tieng-viet.md (macOS section)
  • funput-la-gi.md (download section)
  • chon-bo-go-tieng-viet.md (platform table)

Testing

  • pnpm build passes and the new page is included in the sitemap
  • pnpm seo:check passes (canonical, metadata, JSON-LD, internal links)
  • Checked rendering on the local dev server (tables, figure, TOC); the Astro dev toolbar audit reported no issues
  • Confirm the Vietnamese macOS label for "Text Input" (written as "Nhập văn bản" in Step 2)

Made with Cursor

@pcodedynamics pcodedynamics self-assigned this Oct 5, 2026
@pcodedynamics
pcodedynamics marked this pull request as ready for review October 5, 2026 18:12
@pcodedynamics
pcodedynamics merged commit c2e4ef5 into main Oct 5, 2026
1 check passed
@pcodedynamics
pcodedynamics deleted the cursor/blog-macos-setup-guide branch October 5, 2026 18:13
@pcodedynamics pcodedynamics mentioned this pull request Oct 5, 2026
2 tasks done
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant