@jant/core 0.7.1 → 0.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (329) hide show
  1. package/bin/commands/assets/prepare.js +3 -3
  2. package/bin/commands/db/export.js +115 -2
  3. package/bin/commands/deploy.js +11 -3
  4. package/bin/commands/{search-reindex.js → search/reindex.js} +5 -5
  5. package/bin/commands/site/export.js +48 -36
  6. package/bin/commands/site/import.js +3074 -2
  7. package/bin/commands/site/snapshot/import.js +2 -0
  8. package/bin/commands/telegram/register-webhooks.js +48 -23
  9. package/bin/jant.js +16 -11
  10. package/bin/lib/command-registry.js +120 -0
  11. package/bin/lib/migration-artifacts.js +19 -0
  12. package/bin/lib/renamed-arguments.js +56 -0
  13. package/bin/lib/site-snapshot.js +83 -1
  14. package/dist/{app-ZcaI1kPN.js → app--uxnaIRV.js} +8339 -740
  15. package/dist/client/.vite/manifest.json +3 -3
  16. package/dist/client/_assets/{client-DAhoqPdr.css → client-BCumu1-D.css} +1 -1
  17. package/dist/client/_assets/{client-knSEyUJO.js → client-BT6kpcuG.js} +1 -1
  18. package/dist/client/_assets/{client-auth-CAMfTrKW.js → client-auth-begiT1tq.js} +1 -1
  19. package/dist/index.js +2 -3
  20. package/dist/node.js +2 -3
  21. package/dist/url-CKlGzvdN.js +428 -0
  22. package/package.json +1 -5
  23. package/src/__tests__/cli-commands.test.ts +144 -0
  24. package/src/__tests__/config-docs.test.ts +148 -0
  25. package/src/__tests__/export-import-roundtrip.test.ts +1 -1
  26. package/src/__tests__/feed-docs.test.ts +36 -0
  27. package/src/__tests__/fixtures/releases/0.7.0/site-export/README.md +89 -0
  28. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/0x4nv/index.md +16 -0
  29. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/_index.md +41 -0
  30. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/faqyt/index.md +28 -0
  31. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +18 -0
  32. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/_index.md +4 -0
  33. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +27 -0
  34. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +32 -0
  35. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/archive/_index.md +7 -0
  36. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +27 -0
  37. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/bought-too-many-lemons-again/_index.md +34 -0
  38. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/city-walks/_index.md +11 -0
  39. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/collections/_index.md +4 -0
  40. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/current-tea-rotation/_index.md +31 -0
  41. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +27 -0
  42. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/desk-but-better/_index.md +22 -0
  43. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/e0kcg/_index.md +19 -0
  44. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/featured/_index.md +7 -0
  45. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-basho/_index.md +22 -0
  46. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-epictetus/_index.md +22 -0
  47. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-marcus-aurelius/_index.md +22 -0
  48. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-seneca/_index.md +22 -0
  49. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-thoreau/_index.md +22 -0
  50. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/2cl6d/index.md +16 -0
  51. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/3zqv7/index.md +28 -0
  52. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/5oxsv/index.md +16 -0
  53. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/_index.md +36 -0
  54. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/home-cooking/_index.md +11 -0
  55. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/_index.md +29 -0
  56. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +18 -0
  57. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/a83qu/index.md +16 -0
  58. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/from-seneca-5hibo/index.md +19 -0
  59. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/mynoise-for-rainy-afternoons/_index.md +27 -0
  60. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/nts-archives-are-good-cleaning-music/_index.md +27 -0
  61. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/_index.md +29 -0
  62. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/c91j0/index.md +16 -0
  63. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/qyucy/index.md +16 -0
  64. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/wsgck/index.md +16 -0
  65. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +43 -0
  66. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/reading-notes/_index.md +11 -0
  67. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +27 -0
  68. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/_index.md +41 -0
  69. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/cxiu6/index.md +16 -0
  70. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/t77ms/index.md +16 -0
  71. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/the-soup-trick-i-always-forget/index.md +18 -0
  72. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/telk3/_index.md +27 -0
  73. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/telk3/from-thoreau-pawt2/index.md +17 -0
  74. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +32 -0
  75. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +29 -0
  76. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +27 -0
  77. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/tiny-projects/_index.md +11 -0
  78. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/useful-links/_index.md +11 -0
  79. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/weekend-notes/_index.md +11 -0
  80. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/what-i-actually-use-my-notebook-for/_index.md +49 -0
  81. package/src/__tests__/fixtures/releases/0.7.0/site-export/data/jant.toml +119 -0
  82. package/src/__tests__/fixtures/releases/0.7.0/site-export/hugo.toml +43 -0
  83. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/021801c20ab3-med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  84. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/0f868ce9ac84-med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  85. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/50c2ad911bad-med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  86. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/7a91f0960491-med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  87. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/8714116d3c8e-med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  88. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/8a0b4277443f-med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  89. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/a7d1c8a1afd9-med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  90. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/e25570b405f5-med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  91. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/e89ea4eabf01-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  92. package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  93. package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/custom.css +0 -0
  94. package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/favicon.ico +0 -0
  95. package/src/__tests__/fixtures/releases/0.7.0/snapshot/db.sql +218 -0
  96. package/src/__tests__/fixtures/releases/0.7.0/snapshot/meta.json +9 -0
  97. package/src/__tests__/fixtures/releases/0.7.1/site-export/README.md +89 -0
  98. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/0x4nv/index.md +16 -0
  99. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/_index.md +41 -0
  100. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/faqyt/index.md +28 -0
  101. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +18 -0
  102. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/_index.md +4 -0
  103. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +27 -0
  104. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +32 -0
  105. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/archive/_index.md +7 -0
  106. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +27 -0
  107. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/bought-too-many-lemons-again/_index.md +34 -0
  108. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/city-walks/_index.md +11 -0
  109. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/collections/_index.md +4 -0
  110. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/current-tea-rotation/_index.md +31 -0
  111. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +27 -0
  112. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/desk-but-better/_index.md +22 -0
  113. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/e0kcg/_index.md +19 -0
  114. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/featured/_index.md +7 -0
  115. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-basho/_index.md +22 -0
  116. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-epictetus/_index.md +22 -0
  117. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-marcus-aurelius/_index.md +22 -0
  118. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-seneca/_index.md +22 -0
  119. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-thoreau/_index.md +22 -0
  120. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/2cl6d/index.md +16 -0
  121. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/3zqv7/index.md +28 -0
  122. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/5oxsv/index.md +16 -0
  123. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/_index.md +36 -0
  124. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/home-cooking/_index.md +11 -0
  125. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/_index.md +29 -0
  126. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +18 -0
  127. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/a83qu/index.md +16 -0
  128. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/from-seneca-5hibo/index.md +19 -0
  129. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/mynoise-for-rainy-afternoons/_index.md +27 -0
  130. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/nts-archives-are-good-cleaning-music/_index.md +27 -0
  131. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/_index.md +29 -0
  132. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/c91j0/index.md +16 -0
  133. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/qyucy/index.md +16 -0
  134. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/wsgck/index.md +16 -0
  135. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +43 -0
  136. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/reading-notes/_index.md +11 -0
  137. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +27 -0
  138. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/_index.md +41 -0
  139. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/cxiu6/index.md +16 -0
  140. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/t77ms/index.md +16 -0
  141. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/the-soup-trick-i-always-forget/index.md +18 -0
  142. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/telk3/_index.md +27 -0
  143. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/telk3/from-thoreau-pawt2/index.md +17 -0
  144. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +32 -0
  145. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +29 -0
  146. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +27 -0
  147. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/tiny-projects/_index.md +11 -0
  148. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/useful-links/_index.md +11 -0
  149. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/weekend-notes/_index.md +11 -0
  150. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/what-i-actually-use-my-notebook-for/_index.md +49 -0
  151. package/src/__tests__/fixtures/releases/0.7.1/site-export/data/jant.toml +119 -0
  152. package/src/__tests__/fixtures/releases/0.7.1/site-export/hugo.toml +43 -0
  153. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/021801c20ab3-med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  154. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/0f868ce9ac84-med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  155. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/50c2ad911bad-med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  156. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/7a91f0960491-med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  157. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/8714116d3c8e-med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  158. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/8a0b4277443f-med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  159. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/a7d1c8a1afd9-med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  160. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/e25570b405f5-med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  161. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/e89ea4eabf01-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  162. package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  163. package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/custom.css +0 -0
  164. package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/favicon.ico +0 -0
  165. package/src/__tests__/fixtures/releases/0.7.1/snapshot/db.sql +322 -0
  166. package/src/__tests__/fixtures/releases/0.7.1/snapshot/meta.json +9 -0
  167. package/src/__tests__/fixtures/releases/0.8.0/site-export/README.md +130 -0
  168. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/2thjq/_index.md +25 -0
  169. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/2u5e5/_index.md +35 -0
  170. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/0x4nv/index.md +18 -0
  171. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/_index.md +44 -0
  172. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/faqyt/index.md +30 -0
  173. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +20 -0
  174. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/5kayp/_index.md +23 -0
  175. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/5ynfs/_index.md +31 -0
  176. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/5ynfs/hu597/index.md +21 -0
  177. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/_index.md +5 -0
  178. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +31 -0
  179. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +36 -0
  180. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/archive/_index.md +8 -0
  181. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +30 -0
  182. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/bought-too-many-lemons-again/_index.md +37 -0
  183. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/city-walks/_index.md +12 -0
  184. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/cleanshot-for-screenshots-ocr-and-screen-recording-on-the-mac/_index.md +33 -0
  185. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/cleanshotmac-shang-de-jie-tu-ocr-lu-ping-gong-ju/_index.md +32 -0
  186. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/co344/_index.md +25 -0
  187. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/collections/_index.md +5 -0
  188. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/current-tea-rotation/_index.md +34 -0
  189. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +30 -0
  190. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/desk-but-better/_index.md +25 -0
  191. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/e0kcg/_index.md +22 -0
  192. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/egi3c/_index.md +24 -0
  193. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/evf9j/_index.md +152 -0
  194. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/featured/_index.md +8 -0
  195. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-basho/_index.md +25 -0
  196. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-epictetus/_index.md +25 -0
  197. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-marcus-aurelius/_index.md +25 -0
  198. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-seneca/_index.md +26 -0
  199. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-thoreau/_index.md +25 -0
  200. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/2cl6d/index.md +18 -0
  201. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/3zqv7/index.md +30 -0
  202. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/5oxsv/index.md +18 -0
  203. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/_index.md +39 -0
  204. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gwob9/_index.md +25 -0
  205. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/home-cooking/_index.md +12 -0
  206. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/hz729/_index.md +24 -0
  207. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/inaturalist-ai-zi-ran-she-qu/_index.md +44 -0
  208. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/j4v0q/_index.md +35 -0
  209. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k278t/_index.md +25 -0
  210. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k4eee/_index.md +22 -0
  211. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/_index.md +32 -0
  212. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +20 -0
  213. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/a83qu/index.md +18 -0
  214. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/from-seneca-5hibo/index.md +21 -0
  215. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/kan-qi-lai-bi-jiao-ku-de-gong-si-men/_index.md +41 -0
  216. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/l2m7y/_index.md +29 -0
  217. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/lan-ya-yao-kong-qi-chuang-shang-yue-du-de-fan-ye-shen-qi/_index.md +57 -0
  218. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/mynoise-for-rainy-afternoons/_index.md +30 -0
  219. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/n09le/_index.md +23 -0
  220. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/ni-fu-jin-de-wei-ji-bai-ke-tiao-mu/_index.md +42 -0
  221. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/nts-archives-are-good-cleaning-music/_index.md +30 -0
  222. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/_index.md +32 -0
  223. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/c91j0/index.md +18 -0
  224. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/qyucy/index.md +18 -0
  225. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/wsgck/index.md +18 -0
  226. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +46 -0
  227. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/reading-notes/_index.md +12 -0
  228. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/s4r3e/_index.md +25 -0
  229. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +30 -0
  230. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/_index.md +44 -0
  231. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/cxiu6/index.md +18 -0
  232. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/t77ms/index.md +18 -0
  233. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/the-soup-trick-i-always-forget/index.md +20 -0
  234. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/telk3/_index.md +30 -0
  235. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/telk3/from-thoreau-pawt2/index.md +21 -0
  236. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +36 -0
  237. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +32 -0
  238. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +30 -0
  239. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/tiny-projects/_index.md +12 -0
  240. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/tong-wang-xing-fu-zhi-lu/_index.md +68 -0
  241. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/tou-ma-yan-jiang-ju-le-bu-chu-ti-yan/_index.md +62 -0
  242. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/useful-links/_index.md +12 -0
  243. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/weekend-notes/_index.md +12 -0
  244. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/what-i-actually-use-my-notebook-for/_index.md +52 -0
  245. package/src/__tests__/fixtures/releases/0.8.0/site-export/data/jant.toml +124 -0
  246. package/src/__tests__/fixtures/releases/0.8.0/site-export/hugo.toml +45 -0
  247. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/_redirects +25 -0
  248. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/15d51730a4f7-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  249. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  250. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  251. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  252. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  253. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  254. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  255. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  256. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  257. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q1hme4e8cmby77dn66yy.webp +0 -0
  258. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q2w7e4e8cmc20036yh66.webp +0 -0
  259. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q7d2e4e8cmdeqjmyafby.webp +0 -0
  260. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q887e4e8cmdjssych7yh.webp +0 -0
  261. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp-poster.webp +0 -0
  262. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp.mp4 +0 -0
  263. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf-poster.webp +0 -0
  264. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf.mp4 +0 -0
  265. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb-poster.webp +0 -0
  266. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb.mp4 +0 -0
  267. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83-poster.webp +0 -0
  268. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83.mp4 +0 -0
  269. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167sm0f6ct88qw5brtsgcw.webp +0 -0
  270. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167tf8f6ct88r169s51j49.webp +0 -0
  271. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167vaaf6ct88rbx5ztenwb.webp +0 -0
  272. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167w51f6ct88rp19pybkw1.webp +0 -0
  273. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167x0nf6ct88rzajb84tw3.webp +0 -0
  274. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167xxbf6ct88s5t2300bjk.webp +0 -0
  275. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167yq5f6ct88s9pjwt5fxg.webp +0 -0
  276. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167zg4f6ct88sge8jp28ja.webp +0 -0
  277. package/src/__tests__/fixtures/releases/0.8.0/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  278. package/src/__tests__/fixtures/releases/0.8.0/site-export/themes/jant/static/custom.css +0 -0
  279. package/src/__tests__/fixtures/releases/0.8.0/site-export/themes/jant/static/favicon.ico +0 -0
  280. package/src/__tests__/fixtures/releases/0.8.0/site-export/wrangler.jsonc +24 -0
  281. package/src/__tests__/fixtures/releases/0.8.0/snapshot/db.sql +322 -0
  282. package/src/__tests__/fixtures/releases/0.8.0/snapshot/meta.json +11 -0
  283. package/src/__tests__/helpers/cursor-walk.ts +52 -0
  284. package/src/__tests__/helpers/site-export-import.ts +97 -0
  285. package/src/__tests__/import-site-command.test.ts +27 -1
  286. package/src/__tests__/release-fixtures.test.ts +136 -0
  287. package/src/__tests__/site-export-canonical-import.test.ts +11 -47
  288. package/src/__tests__/theme-docs.test.ts +109 -0
  289. package/src/app.tsx +1 -5
  290. package/src/db/rehearsal-fixtures/pg-demo-current.json +55 -0
  291. package/src/db/rehearsal-fixtures/pg-demo-current.sql +431 -0
  292. package/src/i18n/locales/public/en.po +0 -2
  293. package/src/i18n/locales/public/zh-Hans.po +0 -2
  294. package/src/i18n/locales/public/zh-Hant.po +0 -2
  295. package/src/index.ts +6 -77
  296. package/src/lib/__tests__/post-list-cursor.test.ts +105 -0
  297. package/src/lib/__tests__/timeline.test.ts +14 -14
  298. package/src/lib/__tests__/view.test.ts +0 -46
  299. package/src/lib/feed.ts +0 -6
  300. package/src/lib/post-list-cursor.ts +211 -0
  301. package/src/lib/view.ts +0 -27
  302. package/src/node/__tests__/cli-export.test.ts +2 -2
  303. package/src/node/__tests__/cli-site-snapshot.test.ts +6 -0
  304. package/src/node/__tests__/cli-site-token-env.test.ts +4 -1
  305. package/src/node/__tests__/cli-snapshot-meta.test.ts +64 -0
  306. package/src/routes/api/__tests__/mcp.test.ts +58 -0
  307. package/src/routes/api/__tests__/posts.test.ts +79 -0
  308. package/src/routes/api/internal/search-reindex.ts +1 -1
  309. package/src/routes/api/posts.ts +5 -9
  310. package/src/routes/api/public/__tests__/archive.test.ts +261 -0
  311. package/src/routes/api/public/__tests__/posts.test.ts +344 -19
  312. package/src/routes/api/public/archive.ts +18 -16
  313. package/src/routes/api/public/posts.ts +15 -16
  314. package/src/services/__tests__/media.test.ts +0 -271
  315. package/src/services/__tests__/post.test.ts +342 -36
  316. package/src/services/export.ts +13 -5
  317. package/src/services/mcp.ts +6 -11
  318. package/src/services/media.ts +1 -219
  319. package/src/services/post.ts +513 -319
  320. package/src/styles/ui.css +0 -118
  321. package/src/ui/shared/Pagination.tsx +1 -1
  322. package/bin/commands/export.js +0 -120
  323. package/bin/commands/import-site.js +0 -3034
  324. package/bin/commands/migrate-text-attachments.js +0 -181
  325. package/dist/github-sync-Gw4orAHk.js +0 -8398
  326. package/src/client/multipart-upload.ts +0 -206
  327. package/src/routes/api/__tests__/upload-multipart.test.ts +0 -739
  328. package/src/routes/api/internal/text-attachments.ts +0 -60
  329. package/src/routes/api/upload-multipart.ts +0 -366
@@ -0,0 +1,148 @@
1
+ /**
2
+ * The configuration docs describe the configuration the code reads.
3
+ *
4
+ * Environment variables, settings keys, and reserved paths are part of the
5
+ * compatibility promise, and each lives in code: `CONFIG_FIELDS`, the
6
+ * `Bindings` interface, `RESERVED_PATHS`. The docs drifted from all three —
7
+ * `CJK_SERIF_FONT` stayed documented for months after it was removed,
8
+ * `CORS_ORIGINS` and the rate-limit variables were never documented, and the
9
+ * reserved path list missed `subscribe` and `skill.md`, which a post slug can
10
+ * now collide with. These checks fail on each of those.
11
+ *
12
+ * Environment variables outside `CONFIG_FIELDS` are classified here, so a new
13
+ * one added to `Bindings` has to be documented or declared internal.
14
+ */
15
+
16
+ import { readFileSync } from "node:fs";
17
+ import { join, resolve } from "node:path";
18
+ import { describe, expect, it } from "vitest";
19
+ import { editableSettingKeys } from "../lib/api-settings.js";
20
+ import { RESERVED_PATHS } from "../lib/constants.js";
21
+ import { CONFIG_FIELDS } from "../types/config.js";
22
+
23
+ const CORE_DIR = resolve(import.meta.dirname, "../..");
24
+ const REPO_ROOT = resolve(CORE_DIR, "../..");
25
+ const CONFIGURATION_DOCS = [
26
+ "docs/configuration.md",
27
+ "docs/zh-Hans/configuration.md",
28
+ ];
29
+
30
+ /** Environment variables a self-hosted site may set that `CONFIG_FIELDS` doesn't hold. */
31
+ const PUBLIC_ENV_OUTSIDE_CONFIG_FIELDS = [
32
+ "CORS_ORIGINS",
33
+ "DATABASE_URL",
34
+ "DATA_DIR",
35
+ "DISCOVER_PING_URL",
36
+ "HOST",
37
+ "INTERNAL_ADMIN_TOKEN",
38
+ "LOCAL_PUBLIC_URL",
39
+ "LOCAL_STORAGE_PATH",
40
+ "PORT",
41
+ "RATE_LIMIT_DISABLED",
42
+ "RATE_LIMIT_SEARCH_PER_MIN",
43
+ "TRUST_PROXY",
44
+ ];
45
+
46
+ /**
47
+ * `Bindings` members that are not documented settings: platform bindings,
48
+ * values the runtime sets itself, development-only tokens, and the hosted
49
+ * service's configuration.
50
+ */
51
+ const INTERNAL_BINDINGS = [
52
+ "DB",
53
+ "R2",
54
+ "NODE_DATABASE",
55
+ "NODE_SQLITE",
56
+ "NODE_STARTED_AT",
57
+ "DEV_API_TOKEN",
58
+ "SITE_RESOLUTION_MODE",
59
+ "HOSTED_CONTROL_PLANE_BASE_URL",
60
+ "HOSTED_CONTROL_PLANE_DOMAIN_CHECK_SECRET",
61
+ "HOSTED_CONTROL_PLANE_INTERNAL_BASE_URL",
62
+ "HOSTED_CONTROL_PLANE_INTERNAL_TOKEN",
63
+ "HOSTED_CONTROL_PLANE_PROVIDER_NAME",
64
+ "HOSTED_CONTROL_PLANE_SSO_SECRET",
65
+ ];
66
+
67
+ function readRepoFile(path: string): string {
68
+ return readFileSync(join(REPO_ROOT, path), "utf8");
69
+ }
70
+
71
+ function readBindingKeys(): string[] {
72
+ const source = readFileSync(join(CORE_DIR, "src/types/bindings.ts"), "utf8");
73
+ return [...source.matchAll(/^\s+([A-Z][A-Z0-9_]+)\??:/gm)].flatMap((match) =>
74
+ match[1] ? [match[1]] : [],
75
+ );
76
+ }
77
+
78
+ /** Names in the first cell of every Markdown table row, e.g. `| `PAGE_SIZE` | … |`. */
79
+ function readTableKeys(markdown: string): string[] {
80
+ return [...markdown.matchAll(/^\| `([A-Z][A-Z0-9_]+)`/gm)].flatMap((match) =>
81
+ match[1] ? [match[1]] : [],
82
+ );
83
+ }
84
+
85
+ function readReservedPaths(markdown: string): string[] {
86
+ const section = markdown
87
+ .split(/^## /m)
88
+ .find((part) => /^(Reserved paths|保留路径)\n/.test(part));
89
+ const block = section?.match(/```text\n([\s\S]*?)```/)?.[1] ?? "";
90
+ return block
91
+ .split(/[,\s]+/)
92
+ .map((path) => path.trim())
93
+ .filter(Boolean);
94
+ }
95
+
96
+ const configKeys = Object.keys(CONFIG_FIELDS);
97
+ const publicConfigKeys = Object.entries(CONFIG_FIELDS)
98
+ .filter(([, field]) => !("internal" in field && field.internal))
99
+ .map(([key]) => key);
100
+
101
+ describe("configuration docs", () => {
102
+ it("classifies every Bindings variable", () => {
103
+ const known = new Set([
104
+ ...configKeys,
105
+ ...PUBLIC_ENV_OUTSIDE_CONFIG_FIELDS,
106
+ ...INTERNAL_BINDINGS,
107
+ ]);
108
+ expect(readBindingKeys().filter((key) => !known.has(key))).toEqual([]);
109
+ });
110
+
111
+ it("mentions every public variable and setting in configuration.md", () => {
112
+ const markdown = readRepoFile("docs/configuration.md");
113
+ const missing = [...publicConfigKeys, ...PUBLIC_ENV_OUTSIDE_CONFIG_FIELDS]
114
+ .filter((key) => !new RegExp(`\\b${key}\\b`).test(markdown))
115
+ .sort();
116
+ expect(missing).toEqual([]);
117
+ });
118
+
119
+ for (const path of CONFIGURATION_DOCS) {
120
+ it(`${path} lists no variable the code doesn't read`, () => {
121
+ const known = new Set([
122
+ ...configKeys,
123
+ ...PUBLIC_ENV_OUTSIDE_CONFIG_FIELDS,
124
+ ]);
125
+ const unknown = readTableKeys(readRepoFile(path)).filter(
126
+ (key) => !known.has(key),
127
+ );
128
+ expect(unknown).toEqual([]);
129
+ });
130
+
131
+ it(`${path} lists exactly the reserved paths`, () => {
132
+ expect(readReservedPaths(readRepoFile(path)).sort()).toEqual(
133
+ [...RESERVED_PATHS].sort(),
134
+ );
135
+ });
136
+ }
137
+
138
+ it("lists exactly the editable setting keys in API.md", () => {
139
+ const markdown = readRepoFile("docs/API.md");
140
+ const section =
141
+ markdown
142
+ .split(/^### /m)
143
+ .find((part) => part.startsWith("Editable setting keys\n")) ?? "";
144
+ expect(readTableKeys(section).sort()).toEqual(
145
+ [...editableSettingKeys].sort(),
146
+ );
147
+ });
148
+ });
@@ -16,7 +16,7 @@ import { dirname, join } from "node:path";
16
16
  import { afterEach, beforeEach, describe, expect, it } from "vitest";
17
17
  import { createExportService, type ExportFile } from "../services/export.js";
18
18
  import { parseFrontMatter } from "../lib/hugo-markdown.js";
19
- import { __test__ as importTestHelpers } from "../../bin/commands/import-site.js";
19
+ import { __test__ as importTestHelpers } from "../../bin/commands/site/import.js";
20
20
  import type { Collection, Media, Post } from "../types.js";
21
21
  import {
22
22
  makeCollection,
@@ -0,0 +1,36 @@
1
+ /**
2
+ * Every name Jant writes in its feed namespace is documented for consumers.
3
+ *
4
+ * `docs/feed-reading.md` is the public contract for the `https://jant.me/ns`
5
+ * elements and attributes; `docs/feeds.md` covers `jant:discover`. Before the
6
+ * handout was published, `jant:post`, `jant:thread`, `jant:truncated`, and
7
+ * `jant:page` were described only in an internal document. A new name the
8
+ * renderer starts writing fails this until the docs describe it.
9
+ */
10
+
11
+ import { readFileSync } from "node:fs";
12
+ import { join, resolve } from "node:path";
13
+ import { describe, expect, it } from "vitest";
14
+
15
+ const CORE_DIR = resolve(import.meta.dirname, "../..");
16
+ const REPO_ROOT = resolve(CORE_DIR, "../..");
17
+ const RENDERERS = ["src/lib/feed.ts", "src/lib/discover.ts"];
18
+ const FEED_DOCS = ["docs/feed-reading.md", "docs/feeds.md"];
19
+
20
+ describe("feed docs", () => {
21
+ it("document every jant: name the feed renderers write", () => {
22
+ const written = new Set(
23
+ RENDERERS.flatMap((path) => [
24
+ ...readFileSync(join(CORE_DIR, path), "utf8").matchAll(
25
+ /jant:([a-z]+)/g,
26
+ ),
27
+ ]).flatMap((match) => (match[1] ? [`jant:${match[1]}`] : [])),
28
+ );
29
+ const docs = FEED_DOCS.map((path) =>
30
+ readFileSync(join(REPO_ROOT, path), "utf8"),
31
+ ).join("\n");
32
+
33
+ expect(written.size).toBeGreaterThan(0);
34
+ expect([...written].filter((name) => !docs.includes(name))).toEqual([]);
35
+ });
36
+ });
@@ -0,0 +1,89 @@
1
+ # Jant — Hugo Export
2
+
3
+ This is a static site exported from [Jant](https://github.com/jant-me/jant), ready to build with [Hugo](https://gohugo.io/).
4
+
5
+ ## Install Hugo
6
+
7
+ This export targets Hugo **extended 0.160.1+**.
8
+
9
+ **macOS (Homebrew):**
10
+
11
+ ```sh
12
+ brew install hugo
13
+ ```
14
+
15
+ **Windows (Scoop):**
16
+
17
+ ```sh
18
+ scoop install hugo-extended
19
+ ```
20
+
21
+ **Linux:**
22
+
23
+ Download the extended build from <https://github.com/gohugoio/hugo/releases>.
24
+
25
+ See the [Hugo installation docs](https://gohugo.io/installation/) for more options.
26
+
27
+ ## Quick start
28
+
29
+ Preview locally:
30
+
31
+ ```sh
32
+ hugo serve
33
+ ```
34
+
35
+ Then open <http://localhost:1313> in your browser.
36
+
37
+ Build the site for deployment:
38
+
39
+ ```sh
40
+ hugo --minify
41
+ ```
42
+
43
+ The output goes to the `public/` directory. Upload it to any static host (Netlify, Vercel, Cloudflare Pages, GitHub Pages, etc.).
44
+
45
+ ## Project structure
46
+
47
+ ```
48
+ hugo.toml — Site configuration (baseURL, title, theme, params)
49
+ content/
50
+ _index.md — Home section
51
+ archive/_index.md — Archive section
52
+ collections/_index.md — Collections directory section
53
+ featured/_index.md — Featured section
54
+ {slug}/
55
+ _index.md — Thread root (branch bundle)
56
+ {reply-slug}/
57
+ index.md — Reply (leaf bundle, not rendered as its own URL)
58
+ data/
59
+ jant.toml — Nav items, branding, display preferences, ordered collections directory
60
+ themes/jant/ — Bundled Hugo theme (overrideable via layouts/ at the site root)
61
+ static/ — Copy files here to add them to the published site
62
+ ```
63
+
64
+ ## Customizing
65
+
66
+ - **Site settings** — edit `hugo.toml` to change the baseURL, title, or pagination.
67
+ - **Jant metadata** — `data/jant.toml` drives nav and the collections directory, and is preserved across round-trip import.
68
+ - **Styles** — edit `themes/jant/static/main.css`, or drop a `static/main.css` at the site root to override.
69
+ - **Templates** — add files under `layouts/` at the site root to override the bundled theme.
70
+ - **Debugging** — from a Jant site project, run `npx jant site export --directory ./my-site`, then `cd my-site && hugo serve`.
71
+
72
+ ## Fetching media locally
73
+
74
+ When the source site has a storage provider configured (R2/S3/local proxy), images and attachments in this export link to the provider URL instead of being bundled. That keeps the repo small but means the files aren't on disk — fine if Hugo can reach the internet, not fine if you want a fully self-contained archive.
75
+
76
+ To download every referenced media file into `static/media/` and rewrite the references to local paths, run this from the root of the export:
77
+
78
+ ```sh
79
+ npx @jant/core site pull-media --path .
80
+ ```
81
+
82
+ Safe to re-run; files already on disk are reused. Anything that fails to download keeps its original URL so the site still builds.
83
+
84
+ ## Notes
85
+
86
+ - Each thread is a Hugo branch bundle. Replies live as nested leaf bundles with `build.render = "never"` so they do not produce standalone URLs; they render inside the thread page.
87
+ - `/{reply-slug}/` URLs are preserved via `aliases:` on the root post, so old links still land on the right thread anchor.
88
+ - Media is emitted under `static/media/{id}.ext` and referenced from a flat `media:` array on each post. When a storage provider has a configured public URL (R2/S3/local proxy), the exporter links to the provider URL instead of re-bundling the bytes.
89
+ - Posts with `draft: true` in front matter are only built when you pass `--buildDrafts` to `hugo` / `hugo serve`.
@@ -0,0 +1,16 @@
1
+ ---
2
+ id: "pst_01kn8jtzmzenf98tnj3x0bzmzk"
3
+ date: "2025-09-27T09:00:00.000Z"
4
+ updated: "2026-04-03T02:30:29.000Z"
5
+ slug: "0x4nv"
6
+ type: "post"
7
+ build:
8
+ render: "never"
9
+ list: "local"
10
+ format: "note"
11
+ status: "published"
12
+ visibility: "public"
13
+ summary_text: "I keep forgetting that plants mostly want consistency, not inspiration. Fair enough."
14
+ ---
15
+
16
+ I keep forgetting that plants mostly want consistency, not inspiration. Fair enough.
@@ -0,0 +1,41 @@
1
+ ---
2
+ id: "pst_01kn8jty2henf98tmnw0xzbhet"
3
+ date: "2025-09-27T08:15:00.000Z"
4
+ updated: "2026-04-03T02:30:27.000Z"
5
+ slug: "41q27"
6
+ type: "post"
7
+ aliases:
8
+ - "/the-potting-mix-guide-i-keep-rereading/"
9
+ - "/0x4nv/"
10
+ - "/faqyt/"
11
+ format: "note"
12
+ status: "published"
13
+ visibility: "public"
14
+ summary_text: "Repotted the balcony herbs before breakfast. Basil was dramatic. Mint did not care at all."
15
+ collections:
16
+ - slug: "tiny-projects"
17
+ title: "Tiny Projects"
18
+ collected_at: "2026-04-03T02:30:27.000Z"
19
+ position: 0
20
+ pinned_at: null
21
+ - slug: "weekend-notes"
22
+ title: "Weekend Notes"
23
+ collected_at: "2026-04-03T02:30:27.000Z"
24
+ position: 1
25
+ pinned_at: null
26
+ media:
27
+ - id: "med_01kn8jtx8qenf98tm9ahxr48sw"
28
+ kind: "image"
29
+ src: "/media/0f868ce9ac84-med_01kn8jtx8qenf98tm9ahxr48sw.webp"
30
+ position: 3055
31
+ width: 1200
32
+ height: 900
33
+ original_name: "herbs-window.webp"
34
+ mime_type: "image/webp"
35
+ size: 13352
36
+ provider: "r2"
37
+ storage_key: "media/sit_01kn8jq3t4famtyg9hjd074ckr/files/med_01kn8jtx8qenf98tm9ahxr48sw.webp"
38
+ last_activity_at: "2025-09-27T16:50:00.000Z"
39
+ ---
40
+
41
+ Repotted the balcony herbs before breakfast. Basil was dramatic. Mint did not care at all.
@@ -0,0 +1,28 @@
1
+ ---
2
+ id: "pst_01kn8jv1anenf98tp9ngn8jbyj"
3
+ date: "2025-09-27T16:50:00.000Z"
4
+ updated: "2026-04-03T02:30:30.000Z"
5
+ slug: "faqyt"
6
+ type: "post"
7
+ build:
8
+ render: "never"
9
+ list: "local"
10
+ format: "note"
11
+ status: "published"
12
+ visibility: "public"
13
+ summary_text: "By late afternoon the basil was standing up again. I respect a fast recovery."
14
+ media:
15
+ - id: "med_01kn8jv0jdenf98tp6qr9zgjjc"
16
+ kind: "image"
17
+ src: "/media/8a0b4277443f-med_01kn8jv0jdenf98tp6qr9zgjjc.webp"
18
+ position: 3055
19
+ width: 1200
20
+ height: 900
21
+ original_name: "balcony-light.webp"
22
+ mime_type: "image/webp"
23
+ size: 15058
24
+ provider: "r2"
25
+ storage_key: "media/sit_01kn8jq3t4famtyg9hjd074ckr/files/med_01kn8jv0jdenf98tp6qr9zgjjc.webp"
26
+ ---
27
+
28
+ By late afternoon the basil was standing up again. I respect a fast recovery.
@@ -0,0 +1,18 @@
1
+ ---
2
+ id: "pst_01kn8jtys8enf98tn2zvcq2hsm"
3
+ title: "The potting mix guide I keep rereading"
4
+ date: "2025-09-27T09:40:00.000Z"
5
+ updated: "2026-04-03T02:30:28.000Z"
6
+ slug: "the-potting-mix-guide-i-keep-rereading"
7
+ type: "post"
8
+ build:
9
+ render: "never"
10
+ list: "local"
11
+ format: "link"
12
+ status: "published"
13
+ visibility: "public"
14
+ summary_text: "Basic, clear, and good for confidence when I start overthinking dirt."
15
+ link_url: "https://www.rhs.org.uk/plants/types/houseplants/repotting"
16
+ ---
17
+
18
+ Basic, clear, and good for confidence when I start overthinking dirt.
@@ -0,0 +1,4 @@
1
+ ---
2
+ title: "Jant"
3
+ type: "home"
4
+ ---
@@ -0,0 +1,27 @@
1
+ ---
2
+ id: "pst_01kn8jv2anenf98tpt6kqt3xg6"
3
+ title: "A night heron field guide for my walk folder"
4
+ date: "2026-03-05T09:10:00.000Z"
5
+ updated: "2026-04-03T02:30:32.000Z"
6
+ slug: "a-night-heron-field-guide-for-my-walk-folder"
7
+ type: "post"
8
+ format: "link"
9
+ status: "published"
10
+ visibility: "public"
11
+ summary_text: "Posting this here so I can find it again the next time I see a suspiciously patient bird near the water."
12
+ link_url: "https://www.audubon.org/field-guide/bird/black-crowned-night-heron"
13
+ rating: 4
14
+ collections:
15
+ - slug: "city-walks"
16
+ title: "City Walks"
17
+ collected_at: "2026-04-03T02:30:32.000Z"
18
+ position: 0
19
+ pinned_at: null
20
+ - slug: "useful-links"
21
+ title: "Useful Links"
22
+ collected_at: "2026-04-03T02:30:32.000Z"
23
+ position: 1
24
+ pinned_at: null
25
+ ---
26
+
27
+ Posting this here so I can find it again the next time I see a suspiciously patient bird near the water.
@@ -0,0 +1,32 @@
1
+ ---
2
+ id: "pst_01kn8jv2x0enf98tqf9hm0deme"
3
+ title: "A Quiet Saturday After a Busy Week"
4
+ date: "2025-08-03T09:10:00.000Z"
5
+ updated: "2026-04-03T02:30:32.000Z"
6
+ slug: "a-quiet-saturday-after-a-busy-week"
7
+ type: "post"
8
+ format: "note"
9
+ status: "published"
10
+ visibility: "public"
11
+ summary_text: "Last week felt like six weeks compressed into five days. I spent most of it answering things, moving things, and promising myself I would slow down later. Today was the later I had in mind. Breakfast took an hour. I opened the windows even though it was still cold. I put the phone on the bookshelf and left it there long enough to hear the apartment settle down."
12
+ featured_at: "2026-04-03T02:30:32.000Z"
13
+ featured_post_ids:
14
+ - "pst_01kn8jv2x0enf98tqf9hm0deme"
15
+ featured_sort_at: "2025-08-03T09:10:00.000Z"
16
+ collections:
17
+ - slug: "weekend-notes"
18
+ title: "Weekend Notes"
19
+ collected_at: "2026-04-03T02:30:32.000Z"
20
+ position: 0
21
+ pinned_at: null
22
+ ---
23
+
24
+ Last week felt like six weeks compressed into five days. I spent most of it answering things, moving things, and promising myself I would slow down later. Today was the later I had in mind.
25
+
26
+ Breakfast took an hour. I opened the windows even though it was still cold. I put the phone on the bookshelf and left it there long enough to hear the apartment settle down.
27
+
28
+ <!--more-->
29
+
30
+ What helped most was not turning the free day into a project. I made coffee, wiped the kitchen counter, read twenty pages, and sat in the chair by the window without trying to optimize anything.
31
+
32
+ A good day does not always need a headline. Sometimes it only needs enough room to happen.
@@ -0,0 +1,7 @@
1
+ ---
2
+ title: "Archive"
3
+ type: "archive"
4
+ outputs:
5
+ - "html"
6
+ - "rss"
7
+ ---
@@ -0,0 +1,27 @@
1
+ ---
2
+ id: "pst_01kn8jv3exenf98tqxkzk0sjck"
3
+ title: "Are.na is the only bookmark pile I still revisit"
4
+ date: "2025-10-15T14:15:00.000Z"
5
+ updated: "2026-04-03T02:30:33.000Z"
6
+ slug: "are-na-is-the-only-bookmark-pile-i-still-revisit"
7
+ type: "post"
8
+ format: "link"
9
+ status: "published"
10
+ visibility: "public"
11
+ summary_text: "Most saved links disappear into a hole. This one still feels calm enough to browse on purpose."
12
+ link_url: "https://www.are.na/"
13
+ rating: 4
14
+ collections:
15
+ - slug: "tiny-projects"
16
+ title: "Tiny Projects"
17
+ collected_at: "2026-04-03T02:30:33.000Z"
18
+ position: 0
19
+ pinned_at: null
20
+ - slug: "useful-links"
21
+ title: "Useful Links"
22
+ collected_at: "2026-04-03T02:30:33.000Z"
23
+ position: 1
24
+ pinned_at: null
25
+ ---
26
+
27
+ Most saved links disappear into a hole. This one still feels calm enough to browse on purpose.
@@ -0,0 +1,34 @@
1
+ ---
2
+ id: "pst_01kn8jv4z8enf98trm559j8yeh"
3
+ title: "Bought Too Many Lemons Again"
4
+ date: "2025-11-09T09:20:00.000Z"
5
+ updated: "2026-04-03T02:30:34.000Z"
6
+ slug: "bought-too-many-lemons-again"
7
+ type: "post"
8
+ format: "note"
9
+ status: "published"
10
+ visibility: "public"
11
+ summary_text: "Came home from the market with a bag of lemons, parsley, eggs, and zero idea what dinner was going to be. This keeps happening. I think part of me believes citrus counts as a plan."
12
+ collections:
13
+ - slug: "home-cooking"
14
+ title: "Home Cooking"
15
+ collected_at: "2026-04-03T02:30:34.000Z"
16
+ position: 0
17
+ pinned_at: null
18
+ media:
19
+ - id: "med_01kn8jv452enf98trbkwrvhvgd"
20
+ kind: "image"
21
+ src: "/media/a7d1c8a1afd9-med_01kn8jv452enf98trbkwrvhvgd.webp"
22
+ position: 3055
23
+ width: 1200
24
+ height: 900
25
+ original_name: "market-lemons.webp"
26
+ mime_type: "image/webp"
27
+ size: 16484
28
+ provider: "r2"
29
+ storage_key: "media/sit_01kn8jq3t4famtyg9hjd074ckr/files/med_01kn8jv452enf98trbkwrvhvgd.webp"
30
+ ---
31
+
32
+ Came home from the market with a bag of lemons, parsley, eggs, and zero idea what dinner was going to be.
33
+
34
+ This keeps happening. I think part of me believes citrus counts as a plan.
@@ -0,0 +1,11 @@
1
+ ---
2
+ title: "City Walks"
3
+ slug: "city-walks"
4
+ type: "collection"
5
+ summary_text: "Routes, corners, and small things I notice outside."
6
+ sort_order: "newest"
7
+ entry_count: 3
8
+ outputs:
9
+ - "html"
10
+ - "rss"
11
+ ---
@@ -0,0 +1,4 @@
1
+ ---
2
+ title: "Collections"
3
+ type: "collections"
4
+ ---
@@ -0,0 +1,31 @@
1
+ ---
2
+ id: "pst_01kn8jv5tkenf98ts7b0yqnkww"
3
+ title: "Current Tea Rotation"
4
+ date: "2025-09-06T09:45:00.000Z"
5
+ updated: "2026-04-03T02:30:35.000Z"
6
+ slug: "current-tea-rotation"
7
+ type: "post"
8
+ format: "note"
9
+ status: "published"
10
+ visibility: "public"
11
+ summary_text: "The kitchen shelf is doing a lot of work right now. Jasmine for late afternoonsBlack tea when I need to become a person quicklyMint tea after dinner when I want the day to stop talking Nothing profound here. I just like having a small system for ordinary comfort."
12
+ collections:
13
+ - slug: "home-cooking"
14
+ title: "Home Cooking"
15
+ collected_at: "2026-04-03T02:30:35.000Z"
16
+ position: 0
17
+ pinned_at: null
18
+ - slug: "weekend-notes"
19
+ title: "Weekend Notes"
20
+ collected_at: "2026-04-03T02:30:35.000Z"
21
+ position: 1
22
+ pinned_at: null
23
+ ---
24
+
25
+ The kitchen shelf is doing a lot of work right now.
26
+
27
+ - Jasmine for late afternoons
28
+ - Black tea when I need to become a person quickly
29
+ - Mint tea after dinner when I want the day to stop talking
30
+
31
+ Nothing profound here. I just like having a small system for ordinary comfort.
@@ -0,0 +1,27 @@
1
+ ---
2
+ id: "pst_01kn8jv6c7enf98tsjzb1vw4xy"
3
+ title: "Derek Sivers still writes the kind of internet I want more of"
4
+ date: "2025-11-25T08:50:00.000Z"
5
+ updated: "2026-04-03T02:30:36.000Z"
6
+ slug: "derek-sivers-still-writes-the-kind-of-internet-i-want-more-of"
7
+ type: "post"
8
+ format: "link"
9
+ status: "published"
10
+ visibility: "public"
11
+ summary_text: "Short pages, clear opinions, no inflation. I usually leave with one useful sentence and that is enough."
12
+ link_url: "https://sive.rs/"
13
+ rating: 4
14
+ collections:
15
+ - slug: "reading-notes"
16
+ title: "Reading Notes"
17
+ collected_at: "2026-04-03T02:30:36.000Z"
18
+ position: 0
19
+ pinned_at: null
20
+ - slug: "useful-links"
21
+ title: "Useful Links"
22
+ collected_at: "2026-04-03T02:30:36.000Z"
23
+ position: 1
24
+ pinned_at: null
25
+ ---
26
+
27
+ Short pages, clear opinions, no inflation. I usually leave with one useful sentence and that is enough.
@@ -0,0 +1,22 @@
1
+ ---
2
+ id: "pst_01kn8jv6y3enf98tt74f3p8mmq"
3
+ title: "Desk, But Better"
4
+ date: "2026-03-01T10:45:00.000Z"
5
+ updated: "2026-04-26T17:56:40.000Z"
6
+ slug: "desk-but-better"
7
+ type: "post"
8
+ format: "note"
9
+ status: "published"
10
+ visibility: "public"
11
+ summary_text: "I finally made the desk simple enough that I want to sit down there again. The rule is now: laptop, lamp, notebook, water. If something else lives there, it has to earn the space."
12
+ collections:
13
+ - slug: "tiny-projects"
14
+ title: "Tiny Projects"
15
+ collected_at: "2026-04-03T02:30:36.000Z"
16
+ position: 0
17
+ pinned_at: null
18
+ ---
19
+
20
+ I finally made the desk simple enough that I want to sit down there again.
21
+
22
+ The rule is now: laptop, lamp, notebook, water. If something else lives there, it has to earn the space.
@@ -0,0 +1,19 @@
1
+ ---
2
+ id: "pst_01kn8jv7f7enf98ttjcqgz8bzr"
3
+ date: "2025-08-04T07:25:00.000Z"
4
+ updated: "2026-04-03T02:30:37.000Z"
5
+ slug: "e0kcg"
6
+ type: "post"
7
+ format: "note"
8
+ status: "published"
9
+ visibility: "public"
10
+ summary_text: "Opened every window this morning and the whole place smelled like rain, old wood, and somebody else's toast. Good start."
11
+ collections:
12
+ - slug: "weekend-notes"
13
+ title: "Weekend Notes"
14
+ collected_at: "2026-04-03T02:30:37.000Z"
15
+ position: 0
16
+ pinned_at: null
17
+ ---
18
+
19
+ Opened every window this morning and the whole place smelled like rain, old wood, and somebody else's toast. Good start.
@@ -0,0 +1,7 @@
1
+ ---
2
+ title: "Featured"
3
+ type: "featured"
4
+ outputs:
5
+ - "html"
6
+ - "rss"
7
+ ---