dstutils

help write Don't Starve Docs

Features

• update/delete/rename cache file when you save/delete/rename file automatically
• context menu:
  • generate the Markdown file in the mdDir directory which is corresponding to the code file
  • generate the SUMMARY.md file associated with the mdDir directory
  • open the associated files at the same time
  • export or don't export parts (ctrl + d)

Settings

see example

example

{
  "dstutils.mapRules": [
    {
      "src": { "dir": "temp/scripts-DST", "ext": ".lua", "position": "right" },
      "dst": { "dir": "docs/", "ext": ".md", "position": "left" },
      "cache": {
        "src": { "dir": "docs/", "ext": ".md" },
        "dst": { "dir": "assets/cache/", "ext": ".json" }
      },
      "exclude": ["README", "SUMMARY"]
    }
  ]
}

NOTE

Force newlines to be LF(used in Linux/Mac) instead of CRLF(used in Windows), so recommend Windows users to work in the WSL(Windows Subsystem for Linux) environment. Another way is to configure git and VSCode to convert CRLF to LF automatically:

The below forces git to convert CRLF to LF automatically:

git config --global core.autocrlf true

The below forces VSCode to use LF when creating new files:

{
  "files.eol": "\n"
}

References

1. emeraldwalk/vscode-runonsave: Visual Studio Code extension to run commands whenever a file is saved.
2. How to Get Consistent Line Breaks in vs Code (LF vs CRLF) | Boot.dev