Skip to content
rTS Wiki
Specify
Specify: a lightweight and fast tool to gather information about a Windows computer, designed for support purposes
HWGV
A csv graph reader for .csv hwinfo files
 WebDBG
Online BSOD dump parser
 Hyde
A web editor and CMS for this wiki

Change notes: Jekyll to Astro

All changes and outstanding items to know about for the Jekyll to Astro migration

Completed

  • Removed all {: .no_toc }, {% include toc.md %} because ToC is now on the sidebar
  • Removed all H1’s, they are at the top of each page now based on the title field of the frontmatter
  • A route is setup that redirects /docs/ to / to keep all old links working
  • Replaced callouts to “Alerts”
    • Danger is now Caution
    • Tip was added
    • Success was changed to Tip
  • Frontmatter
    • New
      • description
        • This will be displayed on the “card” for a note on its Index page and under the page title
    • Replaced
      • nav_exclude: false to sidebar:\n hidden: false
      • nav_exclude: true to sidebar:\n hidden: true
      • nav_order to order under the sidebar attribute
      • permalink to slug
      • search_exclude: false to pagefind: true
      • search_exclude: true to pagefind: false
      • layout: default\n removed
    • Notes
      • parent and has_children no longer used
      • last_modified_date no longer used, dates are pulled from Git history
  • All image paths must now be relative. Absolute would require the linked files to be in /public
  • Embeds have a new format, see Contributing.
  • Scripts are imported using a new method, as described here and implemented in Extend-WinRE.
    • The “gotchya” in this is that your script ends with ?raw to import otherwise Astro tries to parse it as JS.
  • Contributors list re-worked, use this method (modified) https://starlight-examples.netlify.app/examples/git-authors/
  • The “index” notes “recommendations.md” are now index.mdx and are hidden from the sidebar but are searchable. They present a directory listing of their respective notes.
  • Redirect_from frontmatter does not work, this is now configured in astro.config.mjs but should really be deprecated entirely.
    • Need to audit for Bookstack links that still exist, /docs to / is already being handled and that is all we will support
  • /assets/ has been deprecated. Markdown files in astro can only use relative paths to images so /src/assets will be used.
  • rules page has been updated

To Do

  • Includes are broken
    • Terms
  • Move menu to left of icon in m
  • Clicking a header should change the URL (make them hrefs)