docs: added extras to docs

lua/tokyonight/extra/init.lua

@@ -1,5 +1,28 @@
 local M = {}
 
+-- map of plugin name to plugin extension
+--- @type table<string, {ext:string, url:string, label:string}>
+-- stylua: ignore
+M.extras = {
+  kitty = {ext = "conf", url = "https://sw.kovidgoyal.net/kitty/conf.html", label = "Kitty"},
+  fish = {ext = "fish", url = "https://fishshell.com/docs/current/index.html", label = "Fish"},
+  fish_themes = {ext = "theme", url = "https://fishshell.com/docs/current/interactive.html#syntax-highlighting", label = "Fish Themes"},
+  alacritty = {ext = "yml", url = "https://github.com/alacritty/alacritty", label = "Alacritty"},
+  wezterm = {ext = "toml", url = "https://wezfurlong.org/wezterm/config/", label = "WezTerm"},
+  tmux = {ext = "tmux", url = "https://github.com/tmux/tmux/wiki", label = "Tmux"},
+  xresources = {ext = "Xresources", url = "https://wiki.archlinux.org/title/X_resources", label = "Xresources"},
+  xfceterm = {ext = "theme", url = "https://docs.xfce.org/apps/terminal/advanced", label = "Xfce Terminal"},
+  foot = {ext = "ini", url = "https://codeberg.org/dnkl/foot", label = "Foot"},
+  tilix = {ext = "json", url = "https://github.com/gnunn1/tilix", label = "Tilix"},
+  iterm = {ext = "itermcolors", url = "https://iterm2.com/", label = "iTerm"},
+  lua = {ext = "lua", url = "https://www.lua.org", label = "Lua Table for testing"},
+  sublime = {ext = "tmTheme", url = "https://www.sublimetext.com/docs/themes", label = "Sublime Text"},
+  delta = {ext = "gitconfig", url = "https://github.com/dandavison/delta", label = "Delta"},
+  terminator = {ext = "conf", url = "https://gnome-terminator.readthedocs.io/en/latest/config.html", label = "Terminator"},
+  prism = {ext = "js", url = "https://prismjs.com", label = "Prism"},
+  windows_terminal = {ext = "json", url = "https://aka.ms/terminal-documentation", label = "Windows Terminal"},
+}
+
 local function write(str, fileName)
   print("[write] extra/" .. fileName)
   vim.fn.mkdir(vim.fs.dirname("extras/" .. fileName), "p")
@@ -8,30 +31,44 @@ local function write(str, fileName)
   file:close()
 end
 
+function M.read_file(file)
+  local fd = assert(io.open(file, "r"))
+  ---@type string
+  local data = fd:read("*a")
+  fd:close()
+  return data
+end
+
+function M.write_file(file, contents)
+  local fd = assert(io.open(file, "w+"))
+  fd:write(contents)
+  fd:close()
+end
+
+function M.docs()
+  local file = vim.fn.fnamemodify(debug.getinfo(1, "S").source:sub(2), ":p:h:h:h:h") .. "/README.md"
+  local tag = "extras"
+  local pattern = "(<%!%-%- " .. tag .. ":start %-%->).*(<%!%-%- " .. tag .. ":end %-%->)"
+  local readme = M.read_file(file)
+  local lines = {}
+  local names = vim.tbl_keys(M.extras)
+  table.sort(names)
+  for _, name in ipairs(names) do
+    info = M.extras[name]
+    table.insert(
+      lines,
+      "- [" .. info.label .. "](" .. info.url .. ") ([" .. name .. "](tree/main/extras/" .. name .. "))"
+    )
+  end
+  readme = readme:gsub(pattern, "%1\n" .. table.concat(lines, "\n") .. "\n%2")
+  M.write_file(file, readme)
+end
+
 function M.setup()
+  M.docs()
   local config = require("tokyonight.config")
   vim.o.background = "dark"
 
-  -- map of plugin name to plugin extension
-  local extras = {
-    kitty = "conf",
-    fish = "fish",
-    fish_themes = "theme",
-    alacritty = "yml",
-    wezterm = "toml",
-    tmux = "tmux",
-    xresources = "Xresources",
-    xfceterm = "theme",
-    foot = "ini",
-    tilix = "json",
-    iterm = "itermcolors",
-    lua = "lua",
-    sublime = "tmTheme",
-    delta = "gitconfig",
-    terminator = "conf",
-    prism = "js",
-    windows_terminal = "json",
-  }
   -- map of style to style name
   local styles = {
     storm = " Storm",
@@ -40,13 +77,13 @@ function M.setup()
     moon = " Moon",
   }
 
-  for extra, ext in pairs(extras) do
+  for extra, info in pairs(M.extras) do
     package.loaded["tokyonight.extra." .. extra] = nil
     local plugin = require("tokyonight.extra." .. extra)
     for style, style_name in pairs(styles) do
       config.setup({ style = style })
       local colors = require("tokyonight.colors").setup({ transform = true })
-      local fname = extra .. "/tokyonight_" .. style .. "." .. ext
+      local fname = extra .. "/tokyonight_" .. style .. "." .. info.ext
       colors["_upstream_url"] = "https://github.com/folke/tokyonight.nvim/raw/main/extras/" .. fname
       colors["_style_name"] = "Tokyo Night" .. style_name
       write(plugin.generate(colors), fname)