Skip to content

changelog.md

Latest commit

聽

History

History
1022 lines (764 loc) 路 55.7 KB

changelog.md

File metadata and controls

1022 lines (764 loc) 路 55.7 KB
Raw
icon log

Changelog

The latest release of Retype is v{{ version }}.

You can find which version you have installed by running the command retype --version.

The entire release archive of Retype is available on NPM and NuGet.

!!! Do have a suggestion for a new feature in Retype? Please open an issue and let's chat. :icon-comment: !!!

Please also check out the [[Feature Log]] for a summary of all new features in each release.

v4.7.0 [!badge @next|info]

Expected early Q3 2026.

v4.6.0 [!badge @latest|info]

Released: 2026-05-25

There were 26 changes in Retype 4.6.0.

See the :icon-sparkles-fill: Feature Log for highlights.

+++ New :icon-shield-check:

  1. New Unlimited pages for Retype Free version
  2. New Table copy markdown to clipboard button
  3. Support extendable, partial, and command-specific Retype config files, see #776
  4. Extensive performance review and improvements

+++ Improved :icon-thumbsup:

  1. Copy in-project files referenced by !file even when not otherwise included, see #833
  2. Add support for Instagram component URL patterns with usernames
  3. Assign a css class to a markdown table column and have it propagate down that column
  4. Reduce the size of permalink button on H4-H6 headings
  5. Revised project setting lastUpdated to enabled false
  6. Sort pages in a folder by YYYY-MM-DD or YYYY-MM date desc
  7. Add target property support to Card components
  8. Update all client libraries to their latest release
  9. Refreshed the Code Block copy button icon states
  10. New theme options for Header title typography, see #832
  11. Upgrade Octicons icons library from v19.23.1 to v19.27.0

+++ Fixed :icon-bug:

  1. Fixed Tags in the navigation are not automatically rendering if Pro mode
  2. Fixed inline SVG image class styling regression introduced by automatic image dimension inference, see #828
  3. Fix include rules hiding sibling resources from :::code and !file, see #833
  4. Fixed preserve page anchor fragments in card links, see #831
  5. Fix icon font-color on stack nav grouping
  6. Fixed horizontal scroll for extra wide tables
  7. Fixed sidebar stack mode regression with nav icons mode all, see #835
  8. Fixed Exception thrown and not handled gracefully if CNAME file value does not match project url setting
  9. Fixed custom SVG card icons fail to render in signal and snap layouts

+++

v4.5.3

Released: 2026-04-09

There was 1 change in Retype 4.5.3.

+++ Fixed :icon-bug:

  1. Fix tags not appearing in the left menu unless nav.tags.enabled: true is explicitly configured

+++

v4.5.0

Released: 2026-04-07

There were 34 changes in Retype 4.5.0.

See the :icon-sparkles-fill: Feature Log for highlights.

+++ New :icon-shield-check:

  1. !badge PRO New tags in the left menu, see #791
  2. New llms.txt support for AI-friendly documentation discovery
  3. New Action plugins for buttons, menus, and links
  4. New signal Card layout
  5. New snap Card layout
  6. New table style options including clean, striped, and equal
  7. New Instagram auto-embed from standalone Markdown links
  8. New Google Maps component support
  9. New sanitized .md source files output along side .html files for each page
  10. New meta tag to expose sanitized markdown via rel="alternate" link tag
  11. New menu item separator configured using type: separator
  12. New page action button with Print, Copy, and other action options, see #761
  13. New handlers for executing basic client-side functionality
  14. New templating {%{{{ page.md }}}%} property to get file path to sanitized .md file

+++ Improved :icon-thumbsup:

  1. Tidy up html output of markdown lists containing block elements
  2. Ensure 100% CommonMark spec html output compliance
  3. Optimize Backlinks generation and page output
  4. Remove permalink from page primary H1 heading
  5. Copy permalink link to clipboard when permalink clicked
  6. New square button style for permalink
  7. Click on TOC column title scrolls page to top
  8. Upgrade Octicons icons library from v19.22.0 to v19.23.1
  9. Add sitemap.xml output and page-level sitemap discovery, see #590
  10. New git-based lastUpdated.date for sitemap lastmod
  11. Remove <priority> elements from sitemap.xml while preserving URL ordering
  12. Cache git last-modified metadata once per build

+++ Fixed :icon-bug:

  1. Fixed Steps component number to label alignment issue
  2. Fixed inline and block comments failing to be removed under some inline and block comment scenarios
  3. Headings should clear floated image alignments, see #343
  4. Clicking back-to-top button should remove #anchor
  5. Local server served sanitized .md files without UTF-8 charset
  6. Fix Octicons workflow run in the CI process
  7. Fix angle brackets stripped from breadcrumbs, TOC, and left nav when used in page titles, see #706
  8. Fix same-page anchor links not expanding collapsed Panels, see #822

+++

v4.4.0

Released: 2026-03-24

There were 21 changes in Retype 4.4.0.

See the :icon-sparkles-fill: Feature Log for highlights.

+++ New :icon-shield-check:

  1. New robust anchor ID based {%{{{ include }}}%} content targeting
  2. New {%{{{ include }}}%} support for Obsidian style block identifiers
  3. New Obsidian style syntax for linking to and embedding block identifiers
  4. Custom icons, see #123, #600, #701

+++ Improved :icon-thumbsup:

  1. New true Accordion mode for collapsed Panel groups
  2. Collapsible Callout component
  3. Improve auto-generated id values for components, see #815
  4. New fallback path finder for local images
  5. Support Obsidian-style nested heading links with multiple # segments
  6. Expand collapsed panel when a targeted anchor ID is inside, see #816
  7. Improve assistive technology support for outbound link elements
  8. Auto detection of logo file within expected resource directories, see #819
  9. Upgrade all retype packages and dependencies

+++ Fixed :icon-bug:

  1. Panel component truncates tab content when tabs have unequal height, see #395, #653 and #813
  2. Panel component ignores loose list formatting and renders all lists as tight, see #813 and #814
  3. False anchor-not-found warnings for IDs on definition list terms, see #67 and #815
  4. Do not nest <figure> element inside of <p></p> tags
  5. Wikilinks resolve path-qualified duplicate filenames to the wrong page
  6. Remove link underline from superscript and subscript links
  7. Fix logo height and width regression introduced in v4.3.0, see #819
  8. Fix Mermaid Gantt chart max-width constraint, see #626

+++

v4.3.0

Released: 2026-03-17

There were 25 changes in Retype 4.3.0.

See the :icon-sparkles-fill: Feature Log for highlights.

+++ New :icon-shield-check:

  1. !badge PRO Add backlinks.exclude and backlinks.include config options, see #809
  2. New sub-menus in header using items
  3. New gh keyboard command to navigate to home page
  4. Locale specific dateFormat, see #573
  5. New logo image branding.logoHeight and branding.logoWidth settings

+++ Improved :icon-thumbsup:

  1. Add backlinks setting to folder configuration
  2. Enable Backlinks for all page types, including blog and page
  3. Include support for + modifier on Obsidian callouts
  4. Support hot-reloading of symlink pages that are modified during retype start
  5. Include twitter meta tags
  6. Improve generation and SEO of heading # anchor links on hover
  7. Move heading anchor link to right side and use link icon
  8. Add permalink support to Steps component
  9. Support wikilinks as path for url of a linkable component
  10. Improve default hyperlink styles
  11. Improve footnotes functionality and UI design, see #676
  12. Update all client library dependencies
  13. Improve SEO optimization of icons used in the navigation components
  14. Improve how the site logo HREF is set and alt attribute using meta.siteName
  15. Add alt attribute on branding logo based on meta.siteName value, see #523
  16. Convert folder nodes within the treenav to <div> instead of <a> elements

+++ Fixed :icon-bug:

  1. "Website Configuration Error" on live reload during retype start, see #807
  2. Failure to stop server when retype stop is called
  3. page.filePath not correctly resolving within template syntax if base root folder, see content
  4. Icon rendering issue when emoji used on Ref component

+++

v4.2.0

Released: 2026-03-11

There were 22 changes in Retype 4.2.0.

See the :icon-sparkles-fill: Feature Log for highlights.

+++ New :icon-shield-check:

  1. !badge PRO New Last updated page label, see #383
  2. !badge PRO New labels project setting to configure all string labels, see #781
  3. New blog.rss project settings for configuring the maxResults, title, description, copyright, and imageUrl
  4. New retype stop CLI command
  5. New Search settings to explicitly exclude or include files, folders, or paths from indexing, see #258
  6. New created and lastUpdated Page settings
  7. New --debounce flag on retype start and start.debounce project setting
  8. New compact layout for the [[Card]] component
  9. New Retype for Obsidian plugin, see #431
  10. New wikilink list pairs syntax for compact card groups
  11. New [ and ] keyboard navigation for Next and Previous page navigation

+++ Improved :icon-thumbsup:

  1. Add blog meta tag RSS feed to all pages if blog exists
  2. Minor UI refinements to the [[Steps]] component
  3. Search results refinements and UI improvements
  4. Automatically read content image dimensions and add to generated <img> attributes
  5. Support reference-style links in button shortcode rendering, see #796
  6. Auto-display icon in reference link component from target frontmatter, see #669

+++ Fixed :icon-bug:

  1. Fix list continuation line separator rendering inside panels, see #780
  2. Fixed anchor link resolution for headings with emoji shortcodes, see #787
  3. Single + in superscript or subscript, see #695

+++

v4.1.0

Released: 2026-03-01

There were 8 changes in Retype 4.1.0.

See the :icon-sparkles-fill: Feature Log for highlights.

+++ New :icon-shield-check:

  1. New search experience with improved ranking, UI, and navigation, see #680
  2. New blog.layout project setting to configure default blog post layout, see #729
  3. New support for setting a unicode character on icon properties, see #785

+++ Improved :icon-thumbsup:

  1. Index code blocks in search results, see #680
  2. Allow pager links to wrap to next line when container width is full

+++ Fixed :icon-bug:

  1. NextPrev project configuration not able to hide or exclude Next and Previous nav elements, see #781
  2. Fix platform detection: Linux arm64 falls through to osx-x64, see #802
  3. Fill empty table cells with a space - &nbsp;

+++

v4.0.1

Released: 2026-02-25

There were 2 changes in Retype v4.0.1.

+++ Improved :icon-thumbsup:

  1. Print stylesheet improvements
  2. Improve scroll position logic and reloading

+++

v4.0.0

Released: 2026-02-23

There were 15 changes in Retype v4.0.0.

See the :icon-sparkles-fill: Feature Log for highlights.

+++ New :icon-shield-check:

  1. New [[Card]] component
  2. New [[Steps]] component
  3. New Question variant for [[Button]] and [[Badge]] components
  4. New project and page variables available to templating, see #619
  5. New content template variables and data
  6. New blog configuration and paging, see #747
  7. New title property on links and footer.links, see #672
  8. New meta.siteName project setting
  9. Complete upgrade to latest libraries and dependencies

+++ Improved :icon-thumbsup:

  1. Upgrade to latest TailwindCSS v4 release
  2. Generate modern Open Graph meta tags
  3. Added color-scheme meta tag to improve light/dark mode integration
  4. Add text selection theme variables (selection-bg, selection-text, etc)
  5. Set custom id and css class attributes on Panel, Tab, Callout, Code Block, and Container components, see #797
  6. Upgrade Octicons icons library from v19.21.2 to v19.22.0

+++ Fixed :icon-bug:

  1. Automatic detection of -dark images failing if hosting from base folder

+++

v3.12.0

Released: 2026-02-10

There were 15 changes in Retype v3.12.0.

See the :icon-sparkles-fill: Feature Log for highlights.

+++ New :icon-shield-check:

  1. !badge PRO New [[Backlinks]] Component, plus Project, and Page settings
  2. New color preview chip for hexadecimal color codes
  3. New detection of dark mode image file names and automatic switching between light and dark images
  4. New favicon dark variant automatic discovery and automatic light/dark switching
  5. New triple-star *** description syntax for page descriptions
  6. New templating.loopLimit Project configuration setting
  7. New target setting on Page, see #795

+++ Improved :icon-thumbsup:

  1. Added translate="no" attribute to inline <code> elements
  2. Remove extra bottom margin when a Callout includes a List, see #769
  3. Add broader theme variables support for Headings H1 > H6
  4. Improve CNAME validation to help prevent deployment misconfigurations
  5. Print stylesheet refinements, see #782
  6. Upgrade Octicons icons library from v19.15.3 to v19.21.2

+++ Fixed :icon-bug:

  1. Fixed skeleton rendering issues with Search and Filter input fields
  2. Fixed favicon auto-discovery path resolution and ensure configured favicons always render

+++

v3.11.0

Released: 2025-07-02

There were 15 changes in Retype v3.11.0.

See the :icon-sparkles-fill: Feature Log for highlights.

+++ New :icon-shield-check:

  1. !badge PRO New theme color customization for base and dark themes, see #42 and #697
  2. !badge PRO New branding.baseColor setting for quick configuration of the project base-color theme variable to left navigation nodes, see #763
  3. !badge PRO New Page level nav.badge setting for adding a badge component to left navigation nodes, see #763
  4. New 3-way Light, Dark, and System color scheme selector, see #421 and #624
  5. New pipe notation syntax support for adding variant to [[Button]], [[Badge]], and Navigation Badge components
  6. New support for icon-only links in header and footer
  7. New base variant for [[Button]], [[Badge]], and [[Callout]]

+++ Improved :icon-thumbsup:

  1. Upgrade to latest release of VueJS
  2. Update to latest v3.3.x release of TailwindCSS
  3. Add keyboard hint into Search field, see #762
  4. Improve templating support within footer.copyright project setting
  5. Hide the placeholder text in the Search and Filter input fields when focused, see #762
  6. Upgrade Octicons icons library from v19.15.2 to v19.15.3
  7. Improve icon margins on icon-only Badge and Button components
  8. Improve print mode rendering

+++ Fixed :icon-bug:

  1. Fixed search input attribute value not being rendered, see #764

+++

v3.10.0

Released: 2025-06-08

There were 13 changes in v3.10.0.

See the :icon-sparkles-fill: Feature Log for highlights.

+++ New :icon-shield-check:

  1. !badge PRO New nextprev project and page setting to configure Next and Previous page navigation, see #34
  2. New Inline and block level hidden [[comments]] using wrapping %%
  3. New [[Callout]] tip variant
  4. New Page meta.description configuration, see #638
  5. New support for adding generic attribute syntax on list items, see #603
  6. New custom anchors using Obsidian ^block syntax

+++ Improved :icon-thumbsup:

  1. Handle case-sensitive #anchor links and resolve if case-insensitive version found
  2. Add translate=\"no\" attribute to code block <pre> element
  3. Add unique id values to important template elements, see #538, #639 and #640
  4. Improve automatic smooth scroll to #anchor on document load
  5. Added rounded css classes including rounded-xl, rounded-2xl, rounded-3xl, rounded-4xl and rounded-full, see v3.10.1

+++ Fixed :icon-bug:

  1. Fixed exception being thrown if order set with a huge number, see #751
  2. Fixed pipe separated dimensions issue where dimensions were added to image label if label is empty
  3. Fixed code block height not rendering correctly if no content in code block
  4. Fixed build error with > [!hint] callout, see v3.10.1
  5. Fixed lists with lowercase letters and roman numerals not rendered correctly, see #760, see v3.10.1
  6. Fixed main layout background color that does not match sidebar background color, see #759, see v3.10.1

+++

v3.9.0

Released: 2025-05-28

There were 19 changes in Retype v3.9.0.

See the :icon-sparkles-fill: Feature Log for highlights.

+++ New :icon-shield-check:

  1. !badge PRO New nav.icons.enabled Project setting to hide icons in navigation, see #381 and #621
  2. !badge PRO New scheme.mode project setting to default initial page rendering to be explicit day,night, or system modes, see #421
  3. New automatic conversion of details > summary elements into Retype Panel component
  4. New print friendly stylesheet to enable better printing of pages, see #85 and #628
  5. New Obsidian style of setting width and height of image, see #694
  6. New question callout component variant, see #223
  7. New support for Notion style callout syntax
  8. New support for Hextra style callout syntax
  9. New support for generic Alert callout syntax style
  10. New support for Just the Docs style of callouts
  11. New support for Sphinx style callout syntax

+++ Improved :icon-thumbsup:

  1. Rename the Alert component to Callout
  2. Support titles on Obsidian style callout syntax plus all Obsidian callout types
  3. Upgrade Octicons icons library from v19.15.1 to v19.15.2
  4. Add background color on nav nodes and refinements to site label

+++ Fixed :icon-bug:

  1. layout: page failing to be recognized on Pages within sub-folders, see #732
  2. Complex anchor id scenarios not being normalized as expected
  3. WikiLink anchor only links to same page anchor not rendering a link
  4. Callout parser confuses title for variant when space follows opening !!!

+++

v3.8.0

Released: 2025-05-05

There were 16 changes in Retype v3.8.0.

See the :icon-sparkles-fill: Feature Log for highlights.

+++ New :icon-shield-check:

  1. !badge PRO New stack navigation mode for Project and Page settings, see #621
  2. New Greek and Hebrew language support, see #730
  3. New YouTube link parsing and embed template generation, see #51
  4. New support for including a file outside the project root when using {%{{{ include }}}%}, see #734
  5. New WikiLink and image WikiLink syntax support, including building Obsidian vaults

+++ Improved :icon-thumbsup:

  1. Switched order of theme switcher buttons with sun in light mode and moon in dark mode
  2. Revised default server to host on port 5001 instead of 5000, see #688
  3. Refinements to automatic detection of search index languages
  4. Improve project locale-specific template rendering
  5. Minor UI refinements
  6. Add home.md to list of default pages in a directory
  7. Add permalink as an alias of route page configuration
  8. Support Description Lists with Single-Space After Colon, see #740
  9. Upgrade Mermaid to the latest v11.6.0 release, see #627, #656, and #716
  10. Improve automatic handling of GitBook image exports, see release v3.8.1

+++ Fixed :icon-bug:

  1. Retype build errors if no matching url is found in wallet, see #549
  2. Fix float rendering issue with definition list content wrapping multiple rows, see #693 +++

v3.7.0

Released: 2025-04-07

There were 6 changes in Retype v3.7.0.

+++ New :icon-shield-check:

  1. New -v flag as an alias on retype --version in CLI
  2. New showSidebarFilter project setting to hide navigation Filter component, see #538 +++ Improved :icon-thumbsup:
  3. Restore support for official Retype Docker containers
  4. Upgrade Octicons to latest v19.15.1 release
  5. Add support for .NET 9.0 and upgrade internal frameworks +++ Fixed :icon-bug:
  6. Fixed Retype version number where build hash was being appended +++

v3.6.0

Released: 2024-09-17

There were 9 changes in Retype v3.6.0.

+++ New :icon-shield-check:

  1. !badge PRO New --strict parameter for retype build, see #618 +++ Improved :icon-thumbsup:
  2. Upgrade Octicons icons library from v19.7.0 to v19.8.0
  3. Allow words to break for the ToC and Headings, see #633
  4. Match folder node if searchLabel includes the filter query, see #646
  5. New link directly into Tab, see #651
  6. Resolve links to Panel titles, see #389, #401, and #659 +++ Fixed :icon-bug:
  7. Folder name starting with 1. creates raw HTML label in nav tree, see #650
  8. Sidebar filter does not work for CamelCase titles, see #696
  9. CI build process failing, see #708 +++

v3.5.0

Released: 2023-09-16

+++ New :icon-shield-check:

  1. New --pro flag during retype start to enable trial mode of Retype Pro features, see #612
  2. New start.pro: true project config to enable trial mode of Retype Pro features, see #612 +++ Improved :icon-thumbsup:
  3. Path independent doc_theme local storage variable, see #624 +++

v3.4.0

Released: 2023-09-08

+++ New :icon-shield-check:

  1. !badge PRO New hub Project config with < header link, see #592
  2. !badge PRO New toc Project and Page config and features, see #598
  3. Automatically scroll ToC with page content, see #375 +++ Improved :icon-thumbsup:
  4. Upgrade Octicons icons library from v19.6.0 to v19.7.0 +++ Fixed :icon-bug:
  5. Tree nav expanded state not saving +++

v3.3.0

Released: 2023-08-31

+++ New :icon-shield-check:

  1. !badge PRO New breadcrumb navigation with Project and Page configs, see #593
  2. New list-icon css class to simplify creating Retype icon lists, see #370 and #603 +++ Improved :icon-thumbsup:
  3. Update all client libraries +++

v3.2.0

Released: 2023-08-23

+++ New :icon-shield-check:

  1. New Description List support +++ Improved :icon-thumbsup:
  2. Upgrade Octicons icons library from v19.4.0 to v19.5.0
  3. Upgrade Octicons icons library from v19.5.0 to v19.6.0 +++ Fixed :icon-bug:
  4. Custom attributes on an image cause Retype to skip handling of component as a figure image
  5. Custom css class not being applied correctly to table element
  6. Escaping single braces inside inline code within headings
  7. Adjust vertical alignment of Badge and Button components when in headings
  8. Anchor is removed from redirect if set to internal page with anchor
  9. Render icon on outbound link only if link contains plain or basic Markdown text, see #589 +++

v3.1.0

Released: 2023-07-23

+++ New :icon-shield-check:

  1. !badge PRO New outbound project config for outbound external link configuration, see #465
  2. !badge PRO New folder level visibility: private and visibility: protected support
  3. New support for Armenian, Kannada, Sankrit, and Telugu languages
  4. The _includes/*.html files include full Templating support, see #282 +++ Improved :icon-thumbsup:
  5. Improved support for Cloudflare Rocket Loader, see #117, #380, and #580
  6. Hide Tabs until finished rendering to avoid flash of unstyled content, see #570
  7. Generated HTML syntax enhancements and clean up, see #583
  8. Update the RU translation file, see #586
  9. Upgrade to latest release of Mermaid see #585
  10. Add cache buster to _watch scripts during retype start
  11. Update client libraries including vue, monaco-editor, simplebar, katex, and lunr-languages (credits)
  12. Upgrade Octicons icons library from v19.1.0 to v19.3.0
  13. Upgrade Octicons icons library from v19.3.0 to v19.4.0 +++ Fixed :icon-bug:
  14. Not supported value WARNING on first build with new locale, see #573
  15. Finish translation file updated
  16. html lang=\"en\" attribute not updated if locale changes, see #574 +++

v3.0.0

Released: 2023-05-29

+++ New :icon-shield-check:

  1. !badge PRO New visibility: private and visibility: protected pages, see #341
  2. New multi-language locale interface support for 22 languages, see #18 and #24
  3. New meta.title page level config, see #346 and #350
  4. New CLI commands and flags, see #94 and #323
  5. New -n flag to prevent default web browser from being opened, see #323
  6. New retype clean CLI command
  7. New named regions with content, see #368
  8. New {%{{{ nonce }}}%} token for cache busting URLs in templates, see #324
  9. New Inter and system based font-family, see #179
  10. New default Welcome page
  11. New sticky TOC button
  12. New context menu shortcuts for Retype components in Edit mode
  13. New custom same name default page for a directory, see #511 +++ Improved :icon-thumbsup:
  14. Add welcome.md to the list of default page file names for the root input folder, see #461
  15. Change default search hotkey to k instead of /
  16. Panel title missing from search index, see #363
  17. Nice looking prompt for password protected pages
  18. Upgrade client and server dependencies
  19. Upgrade to latest release of Turbo
  20. Updated all Prism languages and created new dependency tree process, see #446
  21. Argh... Poppins font doesn't support non-latin character glyphs (cyrillic), see #179
  22. Use Inter font
  23. Revise Plausible default script plausible.js to script.js
  24. Remove Page Edit button on generated Welcome page
  25. Links with icon that are images get empty alt attribute, see #523
  26. Rename server project config to serve
  27. Upgrade Octicons icons library from v17.2.0 to v19.1.0 +++ Fixed :icon-bug:
  28. JavaScript error if one stacked Panel is missing content, see #388
  29. --override command fails when used with a templating data object, see #509
  30. Editor icons are not rendered after monaco has been upgraded
  31. Propagate visibility to all nested pages in watch mode
  32. Messed up meta tag content value generation with escaped sequence, see #513
  33. mark-github icon issue in ref and file components, see #517
  34. Exception thrown if :icon-: is added to a page
  35. Case-insensitive in-memory file system
  36. Prism theme issues after update to latest +++

v2.4.0

Released: 2022-07-14

+++ New :icon-shield-check:

  1. New generator.directoryIndex.append project config.
  2. New generator.trailingSlash project config to instruct whether to add a trailing / when constructing links.
  3. New host config on integrations.plausible. See #272. +++ Fixed :icon-bug:
  4. Extra phantom index.md file if Retype output path ends with a slash char.
  5. Anchored links receive extraneous slash char when generator.directoryIndex.append: true.
  6. Links to home page ignore generator.trailingShash setting.
  7. Link at top-left logo has trailing slash when generator.trailingSlash is set to false.
  8. Pressing enter on search results creates invalid url. See #333.
  9. Parent folder prefixed with an _ underscore do not build properly. See #336.
  10. Broken link to same page when generator.trailingSlash is false. +++

v2.3.0

Released: 2022-05-03

+++ New :icon-shield-check:

  1. Support for full relative URL pathing. See #14, #133, #194, #222, #233, and #276.

  2. New generator.paths project config with source, relative, root options.

  3. New search.preload project config to instruct Retype to preload the search index instead of on demand load.

  4. New generator.directoryIndex.name project config for setting the default document name.

  5. New generator.directoryIndex.altNames project config.

  6. New RETYPE_DEFAULT_HOST environment variable. See #239.

  7. New self-referential canonical meta tag for all pages.

  8. Link to API pages using fully qualified class name path. +++ Fixed :icon-bug:

  9. Exclude all contents of the _includes directory from being deployed.

  10. Exclude files and pages within the _includes directory from the sitemap generation.

  11. Sidebar menu item is not highlighted when missing trailing / in the URL.

  12. Editor font request does not respect base path. See #318.

  13. Syntax errors in yaml files results in corrupt category URLs. See #316.

  14. links to the index document in the mobile sidebar footer not being resolved.

  15. .yml files excluded from deploy even if explicitly declared in include. See #311.

  16. og:url and twitter:url paths incorrect for API generated pages.

  17. Include full version in the generator meta tag version.

  18. Many categories extends beyond page width and does not wrap. See #316. +++ Breaking :icon-shield-x:

  19. Switch generator.paths default value to relative.

To revert to the previous functionality, set the generator.paths config to root in your project retype.yml file.

generator:
  paths: root # Old default functionality

+++

v2.2.0

Released: 2022-03-30

+++ New :icon-shield-check:

  1. generator.recase project config to recase file and folder names. See #302.
  2. Official Retype docker images published to DockerHub. See #122.
  3. New @latest tag to be used in your retype-action.yml configuration.
  4. GitHub Action annotation to announce availability of Retype v2, only if using Retype v1. +++ Fixed :icon-bug:
  5. author, date, and category metadata being rendered above page title
  6. top.md content should be excluded from summary card generation +++

v2.1.0

Released: 2022-03-22

+++ New :icon-shield-check:

  1. Deploy .html and .htm files from input to output by default. See #302.
  2. Apply generic attribute syntax to Retype generated <table> element. +++ Fixed :icon-bug:
  3. Project include config not including pages if _* configured. See #296. +++

v2.0.0

Released: 2022-03-14

+++ New :icon-shield-check:

  1. Redesign of Search results.
  2. Page content live editor during retype start.
  3. Project configuration for full, partial, and basic search index modes.
  4. Content templating.
  5. Disable templating on a page.
  6. Line highlighting in code blocks.
  7. ghost variant on Button, Badge, and Callout.
  8. Custom site-wide includes for <head>, <body>, top.md, and bottom.md.
  9. Support for custom generic attributes on Markdown components.
  10. Support for adding images above the top h1 page heading.
  11. Google Tag Manager integration.
  12. Plausible IO integration.
  13. Page limit handling has been improved during retype start mode.
  14. Include description in search index. +++ Fixed :icon-bug:
  15. Unable to scroll sidebar when navigating to a collapsed clickable sidebar menu. See #128.
  16. Double-quote in image caption is not encoded. See #245.
  17. Build fails if root retype.yml configuration file is blank. See #257.
  18. Super mega long word in page title causes rendering issue. See #253.
  19. Prevent float elements from interacting with Previous|Next buttons. See #232.
  20. Unreliable sidebar and Prev/Next button label word wrapping. See #253.
  21. Full width Callout component content. See #242.
  22. Strange link resolution WARNING on emphasized markdown links. See #291. +++

v1.11.2

Released: 2021-12-23

+++ New :icon-shield-check:

  1. allowFullScreen attribute on the [!embed] component. +++

v1.11.1

Released: 2021-12-02

+++ Fixed :icon-bug:

  1. Badges configured without a link [!badge x] are being ignored.
  2. Horizontal scroll issue with wide table. See #192.
  3. Relax client integrity verification rules. See #225 and #226.
  4. Corrupted website config error appears on first load after rebuild. See #212 and #226. +++

v1.11.0

Released: 2021-11-19

+++ New :icon-shield-check:

  1. Multi-language search and automatic detection of content languages. See #197.
  2. Retype Pro with increased page limit and Retype branding removal option.
  3. Better style for native scrollbars on Windows. See #107.
  4. serve.start.validation project configuration option.
  5. All heading elements within the page content are now added to the search index. See #166.
  6. Page config and SUMMARY.md can be used together.
  7. Upgrade Octicons icons library from v15.2.0 to v16.1.1. +++

v1.10.0

Released: 2021-09-30

+++ New :icon-shield-check:

  1. $\KaTeX$ math typesetting library support.
  2. Auto generate RSS feed for blog posts.
  3. serve.start.polling project option.
  4. Gravatar support for author avatars.
  5. project option to configure a default Gravatar image.
  6. target and icon attributes on [!ref] component.
  7. Smarter link resolution logic. +++

v1.9.0

Released: 2021-08-30

+++ New :icon-shield-check:

  1. Incremental build during retype start with page dependency graph
  2. Ability to run retype start with in-memory output. Turned on by default, see serve.start.mode to configure.
  3. Platform specific NPM packages:
  4. retypeapp-win-x86
  5. retypeapp-win-x64
  6. retypeapp-linux-x64
  7. retypeapp-darwin-x64
  8. Lazy Prism and Mermaid plugin execution for hidden content
  9. Keep scroll position on full page reload during retype start.
  10. Build is so fast now that the client refresh interval can be tightened up to 100ms.
  11. Add target property for linkable components, such as Button and Badge. +++

v1.8.2

Released: 2021-08-06

+++ Fixed :icon-bug:

  1. Update expired NPM Access Token to fix broken NPM package publishing from v1.8.1. +++

v1.8.1

Released: 2021-08-05

+++ New :icon-shield-check:

  1. Add broader checks for unresolved links, see #112. For instance, if a link to ../components is created, Retype will now try to resolve the path to any of the following:
../components.md
../components/index.md
../components/components.md
../components/default.md
  1. Allow inline Markdown components for author, title, and label page configs, see #114. Block-level Markdown components will be ignored for those configs.

+++ Fixed :icon-bug: !!!warning

This release failed to run properly if the NPM package was installed. 馃 We didn't notice that our NPM Access Token had expired between the v1.8.0 and v1.8.1 releases. The expired NPM token caused our automated release process to fail. Sorry about that. 馃槱 Once we figured out what was going wrong, a new NPM Access Token was set and v1.8.2 was released. We have added NPM token pre-checks and verifications to the automated release process to hopefully prevent the issue from ever happening again.

!!! +++

v1.8.0

Released: 2021-08-03

+++ New :icon-shield-check:

  1. retype.yml project configuration file format.
  2. url project config for setting your website URL.
  3. Auto-generate a sitemap.xml file to inform search engines which pages to crawl.
  4. Auto-generate a robots.txt file.
  5. Open Graph and Twitter meta tags generated for every page.
  6. serve.host and serve.port project configs.
  7. /blog summary for any .md page added to a /blog folder.
  8. author, category, and date page configs.
  9. redirect page config.
  10. visibility page config.
  11. Added logic to handle the manual creation of a CNAME file and copy to output.
  12. Automated process to check for new Octicons release and merge update.
  13. Update to latest Octicons icon release.
  14. Cleaned up the CLI experience. See #103.
  15. Removed excessive bottom padding on blockquotes, see #74. +++

v1.7.0

Released: 2021-06-24

+++ New :icon-shield-check:

  1. Column component.
  2. Stacking Panels component.
  3. Open Graph and Twitter card support.
  4. Mermaid diagram and visualization support.
  5. target config for all links within retype.yml.
  6. Default page support for default.md.
  7. Hover style on Badge component when links.
  8. Super improved handling of 谩cc毛nt characters. +++

v1.6.0

Released: 2021-06-09

+++ New :icon-shield-check:

  1. tags config for pages.
  2. :icon-shortcode: component.
  3. include project config.
  4. exclude project config.
  5. Improved <table> styling.
  6. Performance boost for components. +++

v1.5.0

Released: 2021-05-12

+++ New :icon-shield-check:

  1. Badge component
  2. Syntax highlighting support for all code block languages
  3. route page config
  4. port project config
  5. Larger font-size for h1, h2, and h3 headers.
  6. Better handing of special characters within file names.
  7. Cleaner handling of .md pages created by GitHub Wiki. +++

v1.4.0

Released: 2021-04-12

+++ New :icon-shield-check:

  1. Even cleaner upgrade to Retype from GitBook experience
  2. Super fast retype start incremental build process
  3. image alignment and captions
  4. exclude config for retype.yml
  5. blog layout and /blog folder defaults
  6. [!file] component
  7. [!ref] component +++

v1.3.0

Released: 2021-03-30

+++ New :icon-shield-check:

  1. GitHub Actions for Retype.
  2. expanded config on folder configuration.
  3. icon and iconAlign configs on links. +++

v1.2.0

Released: 2021-03-25

+++ New :icon-shield-check:

  1. central layout.
  2. page layout.
  3. Edit this page link.
  4. Previous | Next footer navigation buttons for pages.
  5. order Page level config.
  6. hidden visibility Page level config.
  7. favicon Project config available in retype.yml. +++

v1.1.0

Released: 2021-03-12

+++ New :icon-shield-check:

  1. Tab component.
  2. Button component.
  3. Panel component with expand/collapse.
  4. retype start command.
  5. Live Reload when using retype start.
  6. .yml option for Page or Folder configs.
  7. Code Block title.
  8. line numbering in code blocks. +++

v1.0.0

Released: 2021-02-11

+++ New :icon-shield-check:

  1. Publish to NPM
  2. Publish to NuGet
  3. Initial v1.0.0 release +++