Welcome! You’re browsing the complete online Help for TypeMetal. The same content is available via TypeMetal’s “Help” menu.

TypeMetal User Guide

TypeMetal Version History

2.3

  • Tuned TypeMetal for full compatibility with macOS 14 Sonoma.
  • Updated TypeMetal’s app icon. The original icon is available via TypeMetal’s new “Appearance” settings pane, if desired.
  • Advanced the minimum required macOS version to 10.13. (Now and then we have to keep pace with the times, but after this change TypeMetal still runs on Macs as old as 2011!)
  • Fixed backspacing through a WordPress post’s entire content leaving the post empty and uneditable.
  • Fixed HTML source view update lag when deleting the last remaining character in a run of text.
  • The Attribute Editor now saves uncommitted edits in text fields, when you click outside it to dismiss it.
  • Fixed cropping of toolbar “picker” controls.
  • Updated AppAuth and OpenSSL.
  • Renamed “Twitter” references to “X”.

2.2.9

  • Added an invitation to our “Inside TypeMetal” newsletter to TypeMetal’s Help. Subscribe today for behind-the-scenes insights and expert user tips delivered weekly.
  • Indicate rejection of WordPress username or password more clearly in the sync status UI and sync log.
  • Stability improvements:
    • Fixed a crash that could occur after indexing a WordPress project.
    • Fixed WordPress authentication failures causing crashes.
  • Fixed “Main Style Sheet” picker neglecting to update on Undo of picking a different style sheet.
  • Added code to help diagnose a rare content display problem.
  • Updated starter topic links on the “Using TypeMetal with WordPress” Help page.
  • Updated “Metadata TypeMetal May Add to HTML Files” Help page with links to relevant HTML extension registries.

2.2.8

  • Attachment point improvements for WordPress projects:
    • Updated default attachment point settings to correctly handle most WordPress Block Mode themes out of the box.
    • Added “Featured Image” as a customizable attachment point.
    • Show the warning banner only for missing attachment points that the displayed post or page actually needs. (e.g. “Tags” is only needed for posts that have tags.) Dim warning indicators in the attachment point settings sheet for attachment points that aren’t immediately needed.
  • Added the ability to transform some WordPress blocks into other kinds of WordPress blocks. Right-click the path bar segment for any WordPress block, and see the “Transform to” submenu for what the block can be changed into. You can also use the “Unwrap” menu command to unwrap certain kinds of WordPress blocks, such as a “Quote” block. See “Transforming and Unwrapping Blocks” in the WordPress Block Mode Help topic.
  • Label sites as “Site Title (domain.name)”, in the “Blogging” menu and in window titles.
  • Name a WordPress project’s “blogs” folders in the same way, to allow for duplicate site titles in a given wordpress.com account.
  • Fixed typing popping out of newly created WordPress “Quote” blocks.
  • Fixed handling of WordPress “Pullquote” blocks to match the WordPress editor’s behavior. (Start with and maintain a single paragraph inside, and insert line breaks on [return] or [enter].)
  • Fetch theme name from custom data when syncing with wordpress.com sites.
  • Stability improvements:
    • Fixed crashes that could occur after a blog window was closed, if a sync session or content editing view was active.
    • Fixed an exception during WordPress sync that could cause a crash.
    • Improved robustness of URL completion-list updating, seeking to eliminate crashes that can occur on “Create Link” (Cmd+K).
  • Renamed “Preferences” to “Settings” throughout TypeMetal’s Help/User Guide and UI, for consistency with macOS’ revised terminology.
  • Added Help links to a couple of recent videos on our YouTube channel (“What’s TypeMetal?” and “HTML Formatting Settings”).

2.2.7

  • WordPress sync improvements:
    • Updated WordPress sync to handle new ways that REST API errors can be returned.
    • Improved WordPress sync log error messages, to help diagnose authentication issues users sometimes encounter.
    • Refresh the selected-post content shown in blog editor windows, when sync brings new content in for the selected post.
  • Fixed creation of new paragraphs in WordPress Block Mode content, including special provisions for paragraphs inside a WordPress "Quote" block.
  • Improved handling of "cite" elements in Quote blocks.
  • Fixed “Remove (WordPress Project Name)” command to actually remove the project when “OK” is clicked to confirm.
  • Fixed "Move to Trash".
  • Fixed post/page conflict resolution.
  • Fixed document encoding conversion.
  • Updated OpenSSL.

2.2.6

  • Dark Mode fix for snippet editor insertion point.
  • Appearance fix for picker controls.
  • Updated AppAuth and OpenSSL.

2.2.5

  • Fixed missing display of post/page tags, after a REST-synced WordPress project was reindexed. TypeMetal WordPress projects will automatically reindex when they are first opened with TypeMetal >= 2.2.5, to fix this issue.
  • Fixed REST sync of posts’ and pages’ featured image specifiers, and display, replacement, and removal of featured images in the post/page “Properties” popover. Sync with your site to pull down featured image specifiers. The “Properties” popover should then show a post’s featured image if it has one. You can remove the featured image if desired, or change it by dragging a different image in from the blog’s Media Library window or from a Finder window. When you publish the post (or Save the post, if it’s a draft), the new featured image should appear in the published result (or draft preview) on your WordPress site.
  • Moved media item metadata sync before posts and pages, to facilitate resolving featured image references.
  • Fixed mouse clicks sometimes allowing selections, and potentially opening the element attribute editor, outside the editable areas of a WordPress post/page view (title, content, categories, tags, etc.).
  • Fixed Dark Mode appearance of in-post Categories popover.
  • Added Help menu links to @CoherenceLabs on Twitter and YouTube, and a “Rate TypeMetal” item. Praise on the App Store is greatly appreciated and helps keep TypeMetal going! Thank you!

2.2.4

  • Fixed blog windows failing to open after adding a new WordPress project and completing the first sync.
  • Fixed newly added blogs not appearing in the “Blogging” menu until TypeMetal relaunch.
  • Restored animating post and page titles to the first-time WordPress sync experience.

2.2.3

  • Moved WordPress project reindexing to the background, fixing spins that could occur for WordPress sites with many thousands of posts, pages, or media items. On the rare occasions when a project has to be reindexed (such as after launching TypeMetal with the [Option] key held), TypeMetal now displays indexing progress while keeping the rest of its UI responsive.
  • Optimized indexing of very large projects to speed it up from minutes to seconds.

2.2.2

  • Made WordPress ”Offline” state persistent, and global to all sites.
  • Fixed handling of “Offline” state to reliably suppress syncs and upload of post changes while offline, while ensuring deferred sync/upload when system is next online.
  • Treat [enter] the same as [return], everywhere.

2.2.1

  • Fixed selection/insertion point preservation for Indent/Outdent List Level operations.
  • Fixed snippet insertion at the end of an element to place the snippet inside the element as intended.
  • Fixed [delete] handling of Emoji and other composed character sequences.
  • Fixed memory leaks.
  • Updated OpenSSL.

2.2

  • Big upgrade to WordPress sync: TypeMetal can now communicate with sites using the modern WordPress REST API – improving speed, capability, security, and compatibility vs. the old XML-RPC approach. Automatically enabled for wordpress.com accounts, and selectable in account settings for self-hosted WordPress sites. (Using REST with self-hosted sites currently requires a REST-enabling Basic Authentication plugin. We’re working on adding other authentication options. Email support@coherencelabs.com to let us know what you use!)
  • Completely overhauled WordPress sync session management, status display, and cancellation mechanics. Syncs now stop immediately and reliably when the “Cancel” button is clicked. TypeMetal can now queue syncs to ensure reliable uploads to WordPress, and queues all sync status UI updates on the main thread, eliminating status-update-related crashes and exceptions.
  • Revised TypeMetal's WordPress login UI to make the options and their applicability clearer. Added the ability to choose wordpress.com vs. other hosting via a popup button, and a popup button UI for choosing the protocol to use (REST or XML-RPC).
  • Simplified WordPress post template fetching to work without login (which could sometimes fail).
  • Template handling no longer complains about missing Categories, Tags, or Date attachment points. They’re now treated as optional, since some WordPress themes don’t provide them, some sites don’t use categories and/or tags, and a post’s categories and tags can be easily edited in the post properties UI.
  • Fixes to WordPress media library image handling. Images added to posts should now resolve reliably in the editor and also appear reliably in published posts.
  • Fixed date determination for newly published posts. (Ensure it’s the date of first publication, not the date the draft was begun.)
  • Improved interpretation of date strings received from WordPress.
  • Fixed handling of posts put in TypeMetal’s Trash to move them to WordPress’ Trash on sync.
  • You can now Shift+click in a WordPress post/page list to select a range of posts, and Cmd+click to toggle selection of an individual post. (If you have several old drafts you want to move to the Trash, range selection can be helpful.)
  • Fixed auto-save of just-uploaded drafts to eliminate confusing and needlessly worrisome “The file has been changed by another application” alerts.
  • Improved the local image/resource file caching that helps facilitate working offline.
  • Fixed an editing bug that could prevent a dragged image from being inserted into WordPress block-mode content.
  • Fixed an editing bug where triple-clicking a post body and then typing corrupted the post’s block structure.
  • Fixed an editing bug that could leave empty paragraph (<p>) elements in posts.
  • Restored the block handles and extra padding to ”Show Block Structure” Mode.
  • Fixed a range validation bug in the Source Loupe’s HTML syntax highlighting.
  • Fixed thread-safety issues in sync UI updates.
  • Fixed database save issues.
  • Fixed sync log complaints about “-findHostingAccount” and dropped “-someWebResourceCacheAddedAFile:” notifications after a project has been closed.
  • Sync log no longer logs end-of-sync before a sync actually finishes.

2.1.4

  • Armored TypeMetal against spurious control characters in WordPress post/page content. These could produce malformed server responses and consequent sync failures for some WordPress sites.
  • Help typo fix.

2.1.3

  • WordPress Block Mode fixes for drag-select, arrow-key-navigation, and alignment and color property editing.
  • Added “Getting Support” to the Help page navigation loop.
  • Removed some debug logging that had come along for the ride.

2.1.2

  • TypeMetal is back on the App Store — updated for macOS Monterey, AppleSilicon Macs, and WordPress Block Editing!
  • We’ve added major editor enhancements that support the “Block Mode” content authoring introduced in WordPress 5! Write and edit content that meets the latest, modern WordPress standards.
  • Build modern, resolution-adaptive content using TypeMetal’s updated image handling and support for HTML 5 srcset attributes and <picture> elements. See “Adding Images, Pictures, and Figures” and “Editing Image Attributes”.
  • TypeMetal’s HTML knowledge has been updated to match the current HTML 5 spec. <area>, <data>, <embed>, <picture>, <slot>, and <template> elements are now supported, along with global attributes autocapitalize, autofocus, enterkeyhint, inputmode, itemid, itemprop, itemref, itemscope, itemtype, and nonce.
  • The Attribute Editor for <picture>, <audio>, and <video> elements now has a navigable child list that makes these container elements easier to build and edit.
  • TypeMetal now runs natively on both Apple Silicon and Intel Macs.
  • TypeMetal’s UI has been updated to look right at home on macOS 12 Monterey.
  • macOS’ Dark Mode is now fully supported thanks to appearance updates.
  • Added keyboard shortcuts for “Unwrap <element>” (⌃⇧/), “Remove All Elements from Selection” (⌃⌥⇧/), and “New Snippet from Entire Selection” (⌃⌥⌘/).
  • Allow HTML comments in snippets. (Fixed snippets containing comments failing validation in the completion list.)
  • Replaced the non-undoable default TouchBar items with undoable shortcuts for emphasized and strongly emphasized text and other inline formatting commands.
  • Added a “Fetch Theme Templates” item to the “Blogging” menu, that can be used to pull template updates from a WordPress site without forcing an exhaustive sync.
  • Fixed <u> and <s> element application working only at the insertion point in an HTML 5 document. (Wrapping around selected text wasn’t working.)
  • Fixed an issue that could prevent the Attribute Editor from being shown for a <picture> that’s scrolled at least partly out of view.
  • HTML formatting treats <picture> as a block-level element for improved readability.
  • Fixed initially empty display of WordPress project Media Library window.
  • Fixed a crash that occurred when double-clicking an element kind in the element completion UI.
  • Fixed a crash that could occur when showing the token filter popover in a WordPress project window.
  • Fixed a spin and crash that could occur after the Attachment Point Settings sheet had been shown.
  • Fixed a crash and some other bugs in the <img> element Attribute Editor.
  • Silenced a beep that occurred on “Move List Item Down” (⌃⌘↓).

2.1.1

  • Fixed a crash that could occur when browsing the menus, after double-clicking a few blog posts/pages to open them for editing.
  • Fixed a crash that could occur when invoking “Insert” or “Wrap In…” .
  • When the selection changes, cancel any pending “Insert” or “Wrap In…” and close the popover, if it’s shown.
  • Fixed “Learn More…” tooltips failing to disappear.

2.1

  • macOS Sierra compatibility! Fixed a few minor bugs that would’ve gotten in the way of a great TypeMetal experience.
  • Security updates: App Transport Security conformance, new OpenSSL, new OAuth2!
  • WordPress project window:
    • The post+page list now loads on demand, as it’s scrolled. This, and less aggressive reindexing, improve performance for sites with thousands of posts.
    • Copy Permalink URL” from post+page list context menu now works better. We put more kinds of data on the pasteboard, to help client apps find a kind they want to paste.
    • Index searching is more robust. Because nobody enjoys crashing mid-search — or ever, really.
  • WordPress post editor windows:
    • Post category list now registers edits correctly.
  • Cobwebs cleared, attic dusted, uses of deprecated API replaced.
  • Document properties titlebar popover is gone from WordPress project and post+page editor windows, where it just caused trouble.

2.0.9

  • WordPress sync fixes:
    • TypeMetal now identifies itself to WordPress hosts, enabling service providers to whitelist it.
    • Optional rate-limiting of requests (via settings in the account login UI), as one way to avoid problems with WordPress hosts that use ModSecurity and similar measures to foil malicious attacks.
    • Increased object count per request, to reduce the impact of rate-limiting.
  • Source Loupe fixes:
    • Show Source Loupe” (Cmd+Opt+U) responds immediately again, instead of stalling on first show.
    • Insertion point indicator and content highlighting now track the mouse position more reliably.

2.0.8

  • General HTML editing:
    • Fixed missing mouse pointer in Source Loupe.
    • Disallow deleting <body> element. Clicking <body> in path bar now selects its contents.
  • WordPress sync:
    • Fixed new categories sometimes not syncing from WordPress on a non-exhaustive sync.
    • Allow for custom WordPress XML-RPC URLs.
    • Better sync error diagnostics.
  • WordPress project window:
    • “View in Browser” can find WordPress.com-hosted drafts again.
    • Fixed a crash that could occur when closing a blog project window.
    • Fixed deleted posts not disappearing from the active post list.
  • WordPress post editor windows:
    • Fixed loss of unsaved post title or body changes when applying category or tag edits.
    • Deleting a post’s title or body replaces it with selected placeholder text, so the editable area doesn’t disappear.
    • Preserve empty “href” attributes when saving a post. Better error diagnostics during save.
    • Omit local TypeMetal project files from URL completion lists, for safety.
    • Safety checks to prevent clicking a bad link from causing content loss.
    • Constrain double- and triple-click selection to editable areas.
    • Cmd+click opens links.

2.0.7

  • Critical fix for WordPress.com users: Use HTTPS transport, as now required.
  • Fixed an exception in resource cache URL manipulation, that could cause WordPress syncs to get stuck.
  • Fixed “href” URL edits not sticking when “Show URL suggestions automatically” is unchecked.
  • When there's no URL on the pasteboard, don't autofill a created element's "href" from pasteboard history.
  • Accept [enter] the same as [return], in attribute value text fields.
  • Attribute name completion field no longer says “Search” on Yosemite.

2.0.6

  • Fixed spinning beachball when editing a link’s “href” attribute!
  • Fixed incorrect escaping inside <script> elements.

2.0.5

  • Fixed first-time and exhaustive (Option+click) sync failures, for WordPress.com and other hosts that disable the “wp.getUsersBlogs” XML-RPC call for security reasons. There is a new sign-in process for WordPress.com blogs.
  • Allow sync to complete with overall success when user is denied access to a site’s WordPress “pages” (helps accounts that have posts-only access restrictions).
  • Fall back to “Clear View” mode when template loading fails.
  • User Interface clipping and appearance fixes.

2.0.4

  • Crash, hang, and leak fixes.
  • Fixes to WordPress template handling and “featured image” handling.

2.0.3

  • Maintain original publication date, when publishing an updated post to WordPress
  • Fixes for post list filtering and state restoration in WordPress blog windows
  • Fix for “Wrap In…”

2.0.2

  • Ctrl+click works the same as right-click in WordPress post list.
  • WordPress blog window’s non-editable post view no longer accepts drops.
  • Fix for WordPress project removal (hold [Option] key while browsing “Blogging” menu).
  • Added sync log diagnostics to help identify login-to-fetch-templates failure.

2.0.1

  • Fixes for WordPress sync, and post presentation and editing, including better handling of posts that depend on WordPress' automatic paragraph generation
  • Fixed a crash that could occur after closing the last of a WordPress project's windows
  • TypeMetal Help clarifications and fixes

2.0

WordPress is here!

TypeMetal 2 adds a complete Mac-native experience for publishing to your WordPress sites! (WordPress hosting required.)

TypeMetal’s new WordPress projects provide for:

  • Automatic sync with any WordPress.com-hosted or standard self-hosted WordPress installation
  • Offline browsing, search, editing, and drafting of posts and pages, using a self-contained local copy of your WordPress content that TypeMetal keeps indexed and up to date
  • The ability to edit content right in your rendered pages, using TypeMetal’s revolutionary visual (WYSIWYG) HTML editor and your site’s own theme
  • An optional, uncluttered “Clear View” mode, that helps you focus on your content
  • Truly easy pushbutton publishing, that automatically uploads needed images to your WordPress Media Library

1.2

  • Source Loupe getting in your way? We hear you! A new preference lets you embed it below the content area. Use the new “Show Source Loupe” popup button in TypeMetal’s “General” preference panel to configure the Source Loupe the way you like it.
  • When the Source Loupe is embedded, you can adjust its height and open/close it using the neighboring splitter, touch-scroll inside the Source Loupe to scroll through your entire document’s HTML markup, click in the Source Loupe to position the insertion point at the corresponding point in your document, click-and-drag to select the corresponding range in your document, click an element’s start or end tag to exactly select the element, and double-click an element’s start or end tag to open the Attribute Editor for the element. See the Source Loupe Help page for a complete list of the embedded Source Loupe’s capabilities.
  • Added awareness of HTML 5’s <main>, <dialog>, <rb>, and <rtc> elements. They now validate as proper HTML, appear in the element completion list, and have corresponding checkboxes in the snippet editor’s “Allowed Elements” popover.
  • Fixed <ol> list items within an enclosing <ul> being shown with bullets instead of numbers, when using any of TypeMetal’s bundled style sheets (“Bookly”, “Clarity”, or “Luminance”). The updated stylesheets are now marked as “Version: 1.2”. If you exported or embedded copies of any of these stylesheets, you may want to update your exported or embedded copies. (In an affected document, choose the original bundled stylesheet, then export or embed it again.)
  • References to TypeMetal’s bundled stylesheets are now written as absolute URLs (pointing inside TypeMetal’s app bundle), which enables you to move your HTML files without their stylesheet references breaking.
  • Fixed a stack-blowing recursion crash in file tree scanning, that could occur when encountering filenames containing '/' or ':' characters.
  • Fixed inaccuracies in mapping between document content and the corresponding Source Loupe markup.
  • Help updates and typo fixes.

1.1.3

  • Added support for more filename extensions: TypeMetal now recognizes and will open XHTML documents whose filenames end in .xhtml, .xhtm, .xht, and .xml. (.html, .htm, .shtml, and .shtm are also allowed, for both XHTML and HTML files.)

1.1.2

  • Hop from node to node with agility, using the new Cmd+Opt+↑↓←→ shortcuts!
  • Hop the Attribute Editor from element to element using the same shortcut keys!
  • No more doomsday “Unreasonable Permission Request” sheet! TypeMetal lets you open and edit an HTML file even when it doesn’t have access to all of the image files, stylesheet files, or other resource files that it references. A warning icon in the title bar alerts you to suspect permission requests, and lets you grant additional access if you want, but TypeMetal can also carry on just fine without complete file system access.
  • Fixed failure to load newly added images, failure to visibly switch stylesheets, and other resource load failures that could occur after you saved an Untitled document.
  • Fixed a hang that could occur while reloading a stylesheet.
  • Snippet Set Editor: Fixed expanded snippets appearing to be empty, when opening an already-loaded snippet set for editing.
  • Snippet Set Editor: Fixed “Snippet shorthand example” tooltip being shown for a non-editable snippet shorthand field, and never going away.
  • Fixed URL completion window to be as wide as needed to show long URLs, up to the screen width.

1.1.1

  • Lots of Find and Replace fixes in this update!
    • “Find” more reliably scrolls each found result to visible.
    • “Replace All” puts the replacements where they belong.
    • “Replace” and “Replace All” allow replacing with an empty string.
    • “Replace” no longer gets confused after you perform edits yourself.
    • “Replace” no longer fails for selections whose start and end points aren’t in the same text node.
    • Each “Find”, “Replace”, and Spelling and Grammar step scrolls the result to a more prominent vertically centered position, and pulses the scroll bar(s) to help you see where you are in your document.

1.1

  • Spelling and Grammar Checking! (complete with respect for “lang” and “xml:lang” attributes in potentially mixed-language HTML files!)
  • Fixed more misspellings in TypeMetal's Help pages than we care to admit!
  • Fixed a crash that could occur when closing an HTML file.

1.0.4

  • Fixed path bar context menu no longer appearing after the first right-click or Control+click, sometimes accompanied by a crash (a regression that appeared in version 1.0.3).
  • TypeMetal exactly preserves newlines and whitespace inside <pre> elements, instead of trying to condense whitespace when you move the insertion point or change the selection.

1.0.3

  • JavaScript execution can now be enabled, in TypeMetal's "General" preference panel. As in previous TypeMetal versions, it’s otherwise disabled by default, to prevent documents from self-modifying during editing.
  • Made the Source Loupe a little less transparent, to make its contents easier to read.
  • Validation status lights are now yellow for all but serious structural errors.
  • Validation only warns about unknown (“proprietary”) attributes when “Allow user-defined attributes” isn’t checked.
  • Invalid attribute values show as validation warnings, not as structural errors.
  • Clicking an attribute value warning now opens the attribute editor.
  • “tabindex” and “start” attributes are allowed to have negative values, in an HTML 5 document.
  • <li> “value” and <ol> “start” are required to be non-negative, for other document types.
  • Fixed completion hotkey indication in General Preferences.
  • Added missing “Version History” page to Help book. (You’re reading it!)

1.0.2

  • Robust, stall-free URL completion.
  • The shorthand of a newly created empty snippet is now editable.
  • Snippet disclosure button toggles its visual state correctly.
  • Fixed “Learn more…” Help link in snippet shorthand tooltip.
  • Completion lists open above their owning search field when there isn’t room below, and stay attached to their parent window.
  • Clicking in the content area dismisses attribute editor, even when it has a URL or attribute name completion window open.
  • Paste and Drop reliably add “Block Mode” highlighting to what was pasted or dropped.
  • Fixed “Welcome” document styling.
  • Fixed a crash.
  • Minor Help fixes.

1.0.1

  • Editing behavior improvements
  • Tightened the bolts on some user interface elements
  • Re-calibrated the flux capacitor for June 2013