pandorga 1.2.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 (376) hide show
  1. checksums.yaml +7 -0
  2. data/CHANGELOG.md +77 -0
  3. data/DESIGN.md +1434 -0
  4. data/LICENSE +21 -0
  5. data/README.md +81 -0
  6. data/_data/themes/dark.yml +97 -0
  7. data/_data/themes/light.yml +120 -0
  8. data/_data/themes/shared.yml +37 -0
  9. data/_data/translations.yml +85 -0
  10. data/_includes/chord-tab.html +38 -0
  11. data/_includes/content-runtime/00-config.html +22 -0
  12. data/_includes/content-runtime/10-utils.html +176 -0
  13. data/_includes/content-runtime/20-markdown.html +264 -0
  14. data/_includes/content-runtime/25-code-blocks.html +315 -0
  15. data/_includes/content-runtime/30-includes-bib.html +190 -0
  16. data/_includes/content-runtime/30-includes-xcite.html +122 -0
  17. data/_includes/content-runtime/30-includes.html +365 -0
  18. data/_includes/content-runtime/40-listing.html +225 -0
  19. data/_includes/content-runtime/41-listing-helpers.html +71 -0
  20. data/_includes/content-runtime/42-listing-filter.html +208 -0
  21. data/_includes/content-runtime/43-blocks.html +379 -0
  22. data/_includes/content-runtime/50-detail.html +861 -0
  23. data/_includes/content-runtime/55-toc.html +176 -0
  24. data/_includes/content-runtime/60-fragments.html +567 -0
  25. data/_includes/content-runtime/90-bootstrap.html +76 -0
  26. data/_includes/cut-in.html +10 -0
  27. data/_includes/cv/cv-box.html +18 -0
  28. data/_includes/dict-card.html +24 -0
  29. data/_includes/figure.html +36 -0
  30. data/_includes/home/band-index.html +43 -0
  31. data/_includes/home/band-listing.html +49 -0
  32. data/_includes/mathjax.html +10 -0
  33. data/_includes/ongoing-product.html +1 -0
  34. data/_includes/page/content-runtime.html +20 -0
  35. data/_includes/page/date_evolution.html +19 -0
  36. data/_includes/page/figure-lightbox.html +102 -0
  37. data/_includes/page/formatted_date.html +15 -0
  38. data/_includes/page/hero-default.html +18 -0
  39. data/_includes/page/listing-runtime-attrs.html +8 -0
  40. data/_includes/page/mermaid.html +101 -0
  41. data/_includes/page/network-graph.html +1253 -0
  42. data/_includes/page/page-header.html +41 -0
  43. data/_includes/page/professional-connections.html +2 -0
  44. data/_includes/page/site-footer.html +101 -0
  45. data/_includes/page/timeline-section.html +868 -0
  46. data/_includes/plotly.html +22 -0
  47. data/_includes/theme/dev-reexport.html +100 -0
  48. data/_includes/theme/favicons.html +4 -0
  49. data/_includes/theme/font-loader.html +55 -0
  50. data/_includes/theme/shell-theme-boot.html +115 -0
  51. data/_includes/theme/site-logo.html +6 -0
  52. data/_includes/theme/tailwind-theme-colors.json.liquid +65 -0
  53. data/_includes/theme/tailwind-theme-fonts.json.liquid +6 -0
  54. data/_includes/theme/theme-context.liquid +20 -0
  55. data/_includes/theme/theme-toggle.html +94 -0
  56. data/_includes/theme/theme-vars-block.liquid +161 -0
  57. data/_includes/theme/theme-vars.html +16 -0
  58. data/_includes/transcription.html +80 -0
  59. data/_includes/tweet.html +22 -0
  60. data/_includes/video.html +11 -0
  61. data/_includes/xcite.html +3 -0
  62. data/_includes/youtube-short.html +26 -0
  63. data/_includes/youtube.html +12 -0
  64. data/_layouts/article.html +27 -0
  65. data/_layouts/articles.html +534 -0
  66. data/_layouts/bibliography.html +417 -0
  67. data/_layouts/blog.html +544 -0
  68. data/_layouts/cv.html +393 -0
  69. data/_layouts/home.html +319 -0
  70. data/_layouts/network.html +9 -0
  71. data/_layouts/pandorga/articles.html +4 -0
  72. data/_layouts/pandorga/bibliography.html +4 -0
  73. data/_layouts/pandorga/blog.html +4 -0
  74. data/_layouts/pandorga/cv.html +4 -0
  75. data/_layouts/pandorga/media.html +4 -0
  76. data/_layouts/pandorga/network.html +4 -0
  77. data/_layouts/pandorga/portfolio.html +4 -0
  78. data/_layouts/post.html +7 -0
  79. data/_layouts/product.html +5 -0
  80. data/_layouts/project.html +27 -0
  81. data/_layouts/projects.html +534 -0
  82. data/_layouts/resources.html +387 -0
  83. data/_layouts/shell.html +203 -0
  84. data/_layouts/text.html +246 -0
  85. data/_plugins/bibliography_artifact.rb +57 -0
  86. data/_plugins/content_backend.rb +37 -0
  87. data/_plugins/content_collections.rb +51 -0
  88. data/_plugins/content_detail_paths.rb +58 -0
  89. data/_plugins/content_headers.rb +73 -0
  90. data/_plugins/content_keys.rb +310 -0
  91. data/_plugins/content_local_serve.rb +168 -0
  92. data/_plugins/content_site_adapter.rb +159 -0
  93. data/_plugins/content_validators_hook.rb +20 -0
  94. data/_plugins/content_writing_index.rb +52 -0
  95. data/_plugins/content_writing_paths.rb +55 -0
  96. data/_plugins/force_utf8_encoding.rb +13 -0
  97. data/_plugins/git_chronology.rb +211 -0
  98. data/_plugins/git_metadata.rb +43 -0
  99. data/_plugins/job_sections.rb +25 -0
  100. data/_plugins/lib/content_validators.rb +27 -0
  101. data/_plugins/lib/resource_validator.rb +56 -0
  102. data/_plugins/lib/tag_validator.rb +153 -0
  103. data/_plugins/lib/text_excerpt.rb +56 -0
  104. data/_plugins/lib/writing_entry.rb +107 -0
  105. data/_plugins/local_detail_rewrites.rb +194 -0
  106. data/_plugins/timeline.rb +507 -0
  107. data/_plugins/writing_slug_limits.rb +70 -0
  108. data/assets/css/article.css +1330 -0
  109. data/assets/css/base.css +1432 -0
  110. data/assets/css/cv.css +13 -0
  111. data/assets/css/global-link.css +94 -0
  112. data/assets/css/ledger/bibliography.css +307 -0
  113. data/assets/css/ledger/chrome.css +118 -0
  114. data/assets/css/ledger/cv.css +836 -0
  115. data/assets/css/ledger/detail.css +1270 -0
  116. data/assets/css/ledger/footer.css +298 -0
  117. data/assets/css/ledger/home.css +1490 -0
  118. data/assets/css/ledger/network.css +106 -0
  119. data/assets/css/ledger/projects.css +716 -0
  120. data/assets/css/ledger/rascunhos.css +379 -0
  121. data/assets/css/ledger/sources.css +327 -0
  122. data/assets/css/ledger/writing.css +754 -0
  123. data/assets/tailwind-play.js +15 -0
  124. data/examples/full/Gemfile +7 -0
  125. data/examples/full/_config.yml +92 -0
  126. data/examples/full/_redirects +3 -0
  127. data/examples/full/content/collections/articles/2026-01-01-welcome.md +9 -0
  128. data/examples/full/content/collections/data/contacts.yml +3 -0
  129. data/examples/full/content/collections/data/education.yml +4 -0
  130. data/examples/full/content/collections/jobs/research-fellow.md +12 -0
  131. data/examples/full/content/collections/posts/2026-01-02-note.md +9 -0
  132. data/examples/full/content/collections/products/ledger-tool.md +6 -0
  133. data/examples/full/content/collections/projects/demo-kit.md +10 -0
  134. data/examples/full/content/collections/resources/style-guide.md +7 -0
  135. data/examples/full/content/pages/cv/summary.md +1 -0
  136. data/examples/full/content/pages/headers.yml +20 -0
  137. data/examples/full/index.html +4 -0
  138. data/examples/minimal/Gemfile +7 -0
  139. data/examples/minimal/_config.yml +47 -0
  140. data/examples/minimal/_redirects +3 -0
  141. data/examples/minimal/content/collections/articles/2026-01-01-hello.md +10 -0
  142. data/examples/minimal/content/collections/articles/2026-01-02-second.md +9 -0
  143. data/examples/minimal/content/pages/headers.yml +6 -0
  144. data/examples/minimal/index.html +4 -0
  145. data/exe/pandorga +7 -0
  146. data/functions/api/studio/[[path]].js +562 -0
  147. data/functions/api/studio/_lib/auth.js +131 -0
  148. data/functions/api/studio/_lib/blocks.js +156 -0
  149. data/functions/api/studio/_lib/gemini.js +62 -0
  150. data/functions/api/studio/_lib/github.js +278 -0
  151. data/functions/api/studio/_lib/guidelines.js +143 -0
  152. data/functions/api/studio/_lib/paths.js +76 -0
  153. data/functions/api/studio/_lib/prompts.js +165 -0
  154. data/functions/api/studio/_lib/rate-limit.js +40 -0
  155. data/functions/api/studio/_lib/rewrite.js +136 -0
  156. data/functions/api/studio/_lib/sanitize.js +143 -0
  157. data/lib/pandorga/cli.rb +66 -0
  158. data/lib/pandorga/commands/doctor.rb +66 -0
  159. data/lib/pandorga/commands/export.rb +30 -0
  160. data/lib/pandorga/commands/install_functions.rb +41 -0
  161. data/lib/pandorga/commands/new.rb +113 -0
  162. data/lib/pandorga/commands/publish.rb +53 -0
  163. data/lib/pandorga/commands/serve.rb +34 -0
  164. data/lib/pandorga/commands/studio_schema.rb +309 -0
  165. data/lib/pandorga/jekyll/generator.rb +74 -0
  166. data/lib/pandorga/jekyll/plugins/bibliography_artifact.rb +57 -0
  167. data/lib/pandorga/jekyll/plugins/content_backend.rb +37 -0
  168. data/lib/pandorga/jekyll/plugins/content_collections.rb +51 -0
  169. data/lib/pandorga/jekyll/plugins/content_detail_paths.rb +58 -0
  170. data/lib/pandorga/jekyll/plugins/content_headers.rb +73 -0
  171. data/lib/pandorga/jekyll/plugins/content_keys.rb +310 -0
  172. data/lib/pandorga/jekyll/plugins/content_local_serve.rb +168 -0
  173. data/lib/pandorga/jekyll/plugins/content_site_adapter.rb +159 -0
  174. data/lib/pandorga/jekyll/plugins/content_validators_hook.rb +20 -0
  175. data/lib/pandorga/jekyll/plugins/content_writing_index.rb +52 -0
  176. data/lib/pandorga/jekyll/plugins/content_writing_paths.rb +55 -0
  177. data/lib/pandorga/jekyll/plugins/force_utf8_encoding.rb +13 -0
  178. data/lib/pandorga/jekyll/plugins/git_chronology.rb +211 -0
  179. data/lib/pandorga/jekyll/plugins/git_metadata.rb +43 -0
  180. data/lib/pandorga/jekyll/plugins/job_sections.rb +25 -0
  181. data/lib/pandorga/jekyll/plugins/lib/content_validators.rb +27 -0
  182. data/lib/pandorga/jekyll/plugins/lib/resource_validator.rb +56 -0
  183. data/lib/pandorga/jekyll/plugins/lib/tag_validator.rb +153 -0
  184. data/lib/pandorga/jekyll/plugins/lib/text_excerpt.rb +56 -0
  185. data/lib/pandorga/jekyll/plugins/lib/writing_entry.rb +107 -0
  186. data/lib/pandorga/jekyll/plugins/local_detail_rewrites.rb +194 -0
  187. data/lib/pandorga/jekyll/plugins/timeline.rb +507 -0
  188. data/lib/pandorga/jekyll/plugins/writing_slug_limits.rb +70 -0
  189. data/lib/pandorga/jekyll.rb +15 -0
  190. data/lib/pandorga/object_store_env.rb +51 -0
  191. data/lib/pandorga/registry/schema.yml +115 -0
  192. data/lib/pandorga/registry.rb +279 -0
  193. data/lib/pandorga/version.rb +5 -0
  194. data/lib/pandorga.rb +19 -0
  195. data/scripts/cdn-allowlist.json +19 -0
  196. data/scripts/content/backfill-content-keys.rb +99 -0
  197. data/scripts/content/band_art.rb +362 -0
  198. data/scripts/content/export-content-json.rb +741 -0
  199. data/scripts/content/flatten-ansi-capture.mjs +153 -0
  200. data/scripts/content/hero_portraits.rb +28 -0
  201. data/scripts/content/publish-content-to-object-store.sh +78 -0
  202. data/scripts/content/publish-content-to-r2.sh +5 -0
  203. data/scripts/content/sync-content-json-to-r2.rb +167 -0
  204. data/scripts/content/sync-content-redirects.rb +12 -0
  205. data/scripts/generate-configuration-doc.rb +127 -0
  206. data/scripts/lib/content_license.rb +50 -0
  207. data/scripts/lib/content_storage_config.rb +70 -0
  208. data/scripts/lib/normalize-display-math.mjs +52 -0
  209. data/scripts/lib/r2_json_sync.rb +76 -0
  210. data/scripts/lib/withdrawn_public_objects.rb +23 -0
  211. data/scripts/lib/writing_index_contract.rb +61 -0
  212. data/scripts/pdf/md-to-pdf.mjs +1400 -0
  213. data/scripts/pdf/md-to-pdf.sh +27 -0
  214. data/scripts/test/fixtures/dual-template/_config.yml +32 -0
  215. data/scripts/test/fixtures/dual-template/index.html +4 -0
  216. data/scripts/test/render-parity/article-note.json +5 -0
  217. data/scripts/test/render-parity/blockquote.json +5 -0
  218. data/scripts/test/render-parity/blocks/ansi-basic.json +7 -0
  219. data/scripts/test/render-parity/blocks/ansi-bold-is-bright.json +7 -0
  220. data/scripts/test/render-parity/blocks/ansi-drops-cursor-moves.json +7 -0
  221. data/scripts/test/render-parity/blocks/ansi-escapes-markup.json +7 -0
  222. data/scripts/test/render-parity/blocks/ansi-extended-colour.json +7 -0
  223. data/scripts/test/render-parity/blocks/ansi-real-control-byte.json +7 -0
  224. data/scripts/test/render-parity/blocks/archive-card-date-once.json +19 -0
  225. data/scripts/test/render-parity/blocks/archive-card-empty-foot.json +7 -0
  226. data/scripts/test/render-parity/blocks/archive-card-footer-dates.json +22 -0
  227. data/scripts/test/render-parity/blocks/archive-card-meta-parts.json +26 -0
  228. data/scripts/test/render-parity/blocks/archive-card.json +32 -0
  229. data/scripts/test/render-parity/blocks/cta-link.json +13 -0
  230. data/scripts/test/render-parity/blocks/lang-pill-pt.json +8 -0
  231. data/scripts/test/render-parity/blocks/lang-pill.json +8 -0
  232. data/scripts/test/render-parity/blocks/ledger-row-meta-parts.json +29 -0
  233. data/scripts/test/render-parity/blocks/ledger-row.json +35 -0
  234. data/scripts/test/render-parity/blocks/meta-strip.json +27 -0
  235. data/scripts/test/render-parity/blocks/poster-media-image.json +8 -0
  236. data/scripts/test/render-parity/blocks/poster-media-video.json +9 -0
  237. data/scripts/test/render-parity/blocks/section-banner.json +13 -0
  238. data/scripts/test/render-parity/blocks/system-card-custom-meta.json +22 -0
  239. data/scripts/test/render-parity/blocks/system-card.json +48 -0
  240. data/scripts/test/render-parity/blocks/tag-chips-links.json +12 -0
  241. data/scripts/test/render-parity/blocks/tag-chips.json +9 -0
  242. data/scripts/test/render-parity/cut-in-blank-line.json +9 -0
  243. data/scripts/test/render-parity/cut-in-right.json +9 -0
  244. data/scripts/test/render-parity/cut-in.json +8 -0
  245. data/scripts/test/render-parity/figure.json +5 -0
  246. data/scripts/test/render-parity/load-runtime.mjs +337 -0
  247. data/scripts/test/render-parity/ongoing-product.json +5 -0
  248. data/scripts/test/render-parity/plotly.json +5 -0
  249. data/scripts/test/render-parity/poem.json +5 -0
  250. data/scripts/test/render-parity/run-absent-field-checks.mjs +232 -0
  251. data/scripts/test/render-parity/run-block-fixture.mjs +86 -0
  252. data/scripts/test/render-parity/run-detail-parity-checks.mjs +123 -0
  253. data/scripts/test/render-parity/run-field-flow-checks.mjs +227 -0
  254. data/scripts/test/render-parity/run-fixture.mjs +159 -0
  255. data/scripts/test/render-parity/selectors.mjs +43 -0
  256. data/scripts/test/render-parity/video.json +5 -0
  257. data/scripts/test/render-parity/youtube-short.json +10 -0
  258. data/scripts/test/render-parity/youtube.json +8 -0
  259. data/scripts/test/test-absent-field-absent-element.rb +43 -0
  260. data/scripts/test/test-cdn-pins.rb +44 -0
  261. data/scripts/test/test-cloudflare-watch-paths-doc.rb +31 -0
  262. data/scripts/test/test-configuration-doc.rb +36 -0
  263. data/scripts/test/test-content-detail-urls.rb +346 -0
  264. data/scripts/test/test-content-keys.rb +110 -0
  265. data/scripts/test/test-content-license.rb +45 -0
  266. data/scripts/test/test-content-render-parity.rb +38 -0
  267. data/scripts/test/test-content-validators.rb +12 -0
  268. data/scripts/test/test-css-structure.rb +72 -0
  269. data/scripts/test/test-cv-export-contract.rb +158 -0
  270. data/scripts/test/test-detail-render-parity.rb +40 -0
  271. data/scripts/test/test-dev-reexport.rb +122 -0
  272. data/scripts/test/test-doctor.rb +39 -0
  273. data/scripts/test/test-dual-template-instances.rb +87 -0
  274. data/scripts/test/test-dual-template-runtime.rb +167 -0
  275. data/scripts/test/test-examples-build.rb +60 -0
  276. data/scripts/test/test-export-content-json-incremental.rb +138 -0
  277. data/scripts/test/test-export.rb +53 -0
  278. data/scripts/test/test-exported-fields-reach-the-view.rb +60 -0
  279. data/scripts/test/test-form-control-theming.rb +143 -0
  280. data/scripts/test/test-git-chronology.rb +414 -0
  281. data/scripts/test/test-hero-portraits.mjs +97 -0
  282. data/scripts/test/test-hero-portraits.rb +162 -0
  283. data/scripts/test/test-home-band-art.rb +135 -0
  284. data/scripts/test/test-install-functions.rb +39 -0
  285. data/scripts/test/test-language-export.rb +79 -0
  286. data/scripts/test/test-listing-filter-contract.rb +119 -0
  287. data/scripts/test/test-math-row-breaks.mjs +79 -0
  288. data/scripts/test/test-math-row-breaks.rb +18 -0
  289. data/scripts/test/test-new.rb +113 -0
  290. data/scripts/test/test-no-personal-data.rb +85 -0
  291. data/scripts/test/test-public-cv-export.rb +164 -0
  292. data/scripts/test/test-r2-config-consistency.rb +57 -0
  293. data/scripts/test/test-r2-json-sync.rb +193 -0
  294. data/scripts/test/test-registry-home.rb +34 -0
  295. data/scripts/test/test-runtime-js-syntax.rb +64 -0
  296. data/scripts/test/test-slim-writing-index.rb +126 -0
  297. data/scripts/test/test-studio-api-contract.rb +99 -0
  298. data/scripts/test/test-studio-content-files.rb +79 -0
  299. data/scripts/test/test-studio-liquid-roundtrip.mjs +179 -0
  300. data/scripts/test/test-studio-rate-limit.mjs +70 -0
  301. data/scripts/test/test-studio-rewrite-api-contract.rb +59 -0
  302. data/scripts/test/test-studio-rewrite-sanitize.mjs +210 -0
  303. data/scripts/test/test-studio-schema-composition.rb +126 -0
  304. data/scripts/test/test-studio-slug-config.rb +167 -0
  305. data/scripts/test/test-template-packages.rb +51 -0
  306. data/scripts/test/test-text-excerpt.rb +51 -0
  307. data/scripts/test/test-unwrap-media-src.mjs +39 -0
  308. data/scripts/test/test-unwrap-media-src.rb +19 -0
  309. data/scripts/test/test-withdrawn-content-export.rb +69 -0
  310. data/scripts/test/test-writing-index-export-slugs.rb +84 -0
  311. data/scripts/test/test-writing-slug-limits.rb +61 -0
  312. data/scripts/test/test-xcite-chronology.rb +106 -0
  313. data/scripts/validate.sh +74 -0
  314. data/scripts/visual/build-cv-pages-json.js +33 -0
  315. data/scripts/visual/build-site-pages-json.js +94 -0
  316. data/scripts/visual/publish-visual-inspection-to-r2.sh +42 -0
  317. data/scripts/visual/take-screenshots.js +88 -0
  318. data/scripts/visual/visual-inspection-pages.json +113 -0
  319. data/studio/assets/index-B_j0pMD5.css +1 -0
  320. data/studio/assets/index-Ch4YEv9g.js +285 -0
  321. data/studio/index.html +27 -0
  322. data/studio/schema.yml +869 -0
  323. data/studio-app/README.md +27 -0
  324. data/studio-app/index.html +26 -0
  325. data/studio-app/package-lock.json +2499 -0
  326. data/studio-app/package.json +26 -0
  327. data/studio-app/skills-lock.json +47 -0
  328. data/studio-app/src/api/client.js +71 -0
  329. data/studio-app/src/editor/body-editor.js +70 -0
  330. data/studio-app/src/editor/liquid-core.js +382 -0
  331. data/studio-app/src/editor/liquid.js +77 -0
  332. data/studio-app/src/lib/document.js +207 -0
  333. data/studio-app/src/lib/list-controls.js +317 -0
  334. data/studio-app/src/lib/schema.js +66 -0
  335. data/studio-app/src/lib/yaml-doc.js +100 -0
  336. data/studio-app/src/main.js +3693 -0
  337. data/studio-app/src/media/browser.js +578 -0
  338. data/studio-app/src/preview/render.js +430 -0
  339. data/studio-app/src/styles/studio.css +2826 -0
  340. data/studio-app/vite.config.js +25 -0
  341. data/templates/articles/README.md +40 -0
  342. data/templates/articles/fixtures/article.md +9 -0
  343. data/templates/articles/screenshots/README.md +6 -0
  344. data/templates/articles/studio.yml +73 -0
  345. data/templates/articles/template.yml +21 -0
  346. data/templates/bibliography/README.md +41 -0
  347. data/templates/bibliography/fixtures/references.json +9 -0
  348. data/templates/bibliography/screenshots/README.md +6 -0
  349. data/templates/bibliography/studio.yml +66 -0
  350. data/templates/bibliography/template.yml +18 -0
  351. data/templates/blog/README.md +38 -0
  352. data/templates/blog/fixtures/post.md +9 -0
  353. data/templates/blog/screenshots/README.md +6 -0
  354. data/templates/blog/studio.yml +69 -0
  355. data/templates/blog/template.yml +20 -0
  356. data/templates/cv/README.md +34 -0
  357. data/templates/cv/fixtures/job.md +12 -0
  358. data/templates/cv/screenshots/README.md +6 -0
  359. data/templates/cv/studio.yml +200 -0
  360. data/templates/cv/template.yml +25 -0
  361. data/templates/media/README.md +38 -0
  362. data/templates/media/fixtures/resource.md +7 -0
  363. data/templates/media/screenshots/README.md +6 -0
  364. data/templates/media/studio.yml +58 -0
  365. data/templates/media/template.yml +17 -0
  366. data/templates/network/README.md +34 -0
  367. data/templates/network/fixtures/sources.json +3 -0
  368. data/templates/network/screenshots/README.md +6 -0
  369. data/templates/network/studio.yml +28 -0
  370. data/templates/network/template.yml +10 -0
  371. data/templates/portfolio/README.md +39 -0
  372. data/templates/portfolio/fixtures/project.md +10 -0
  373. data/templates/portfolio/screenshots/README.md +6 -0
  374. data/templates/portfolio/studio.yml +89 -0
  375. data/templates/portfolio/template.yml +18 -0
  376. metadata +505 -0
@@ -0,0 +1,190 @@
1
+ {% raw %}
2
+ var bibliographyIndex = null;
3
+ var bibliographyPromise = null;
4
+
5
+ function ensureBibliographyIndex() {
6
+ if (bibliographyIndex) return Promise.resolve(bibliographyIndex);
7
+ if (!bibliographyPromise) {
8
+ bibliographyPromise = loadJson('collections/bibliography/references.json').then(function (data) {
9
+ bibliographyIndex = data || {};
10
+ return bibliographyIndex;
11
+ }).catch(function (error) {
12
+ bibliographyPromise = null;
13
+ bibliographyIndex = {};
14
+ return bibliographyIndex;
15
+ });
16
+ }
17
+ return bibliographyPromise;
18
+ }
19
+
20
+ function bibField(entry, name) {
21
+ var fields = (entry && entry.fields) || {};
22
+ return String(fields[name] == null ? '' : fields[name]).trim();
23
+ }
24
+
25
+ function splitBibAuthors(raw) {
26
+ var authors = [];
27
+ var current = '';
28
+ var depth = 0;
29
+ var text = String(raw || '');
30
+ for (var i = 0; i < text.length; i++) {
31
+ var ch = text[i];
32
+ if (ch === '{') {
33
+ depth++;
34
+ current += ch;
35
+ continue;
36
+ }
37
+ if (ch === '}') {
38
+ depth--;
39
+ current += ch;
40
+ continue;
41
+ }
42
+ if (depth === 0 && text.slice(i, i + 5) === ' and ') {
43
+ if (current.trim()) authors.push(current.trim());
44
+ current = '';
45
+ i += 4;
46
+ continue;
47
+ }
48
+ current += ch;
49
+ }
50
+ if (current.trim()) authors.push(current.trim());
51
+ return authors;
52
+ }
53
+
54
+ function formatIeeeAuthor(name) {
55
+ var author = String(name || '').trim();
56
+ if (!author) return '';
57
+ if (author.charAt(0) === '{' && author.charAt(author.length - 1) === '}') {
58
+ return escapeHtml(author.slice(1, -1));
59
+ }
60
+ var parts = author.split(',');
61
+ if (parts.length < 2) return escapeHtml(author);
62
+ var last = parts[0].trim();
63
+ var first = parts.slice(1).join(',').trim();
64
+ var initials = first.split(/\s+/).filter(Boolean).map(function (word) {
65
+ return escapeHtml(word.charAt(0)) + '.';
66
+ }).join(' ');
67
+ return initials + ' ' + escapeHtml(last);
68
+ }
69
+
70
+ function formatIeeeAuthors(field) {
71
+ var authors = splitBibAuthors(field);
72
+ if (!authors.length) return '';
73
+ var formatted = authors.map(formatIeeeAuthor);
74
+ if (formatted.length === 1) return formatted[0];
75
+ if (formatted.length === 2) return formatted[0] + ' and ' + formatted[1];
76
+ return formatted.slice(0, -1).join(', ') + ', and ' + formatted[formatted.length - 1];
77
+ }
78
+
79
+ function formatIeeeEntry(entry, number) {
80
+ var type = (entry && entry.type) || 'misc';
81
+ var author = formatIeeeAuthors(bibField(entry, 'author'));
82
+ var title = bibField(entry, 'title');
83
+ var year = bibField(entry, 'year');
84
+ var url = bibField(entry, 'url');
85
+ var parts = [];
86
+
87
+ if (type === 'book') {
88
+ if (author) parts.push(author);
89
+ if (title) parts.push('<em>' + escapeHtml(title) + '</em>');
90
+ var publisher = bibField(entry, 'publisher');
91
+ var tail = [publisher, year].filter(Boolean).join(', ');
92
+ if (tail) parts.push(escapeHtml(tail) + '.');
93
+ } else if (type === 'article') {
94
+ if (author) parts.push(author + ',');
95
+ if (title) parts.push('"' + escapeHtml(title) + ',"');
96
+ var journal = bibField(entry, 'journal');
97
+ if (journal) parts.push('<em>' + escapeHtml(journal) + '</em>');
98
+ var meta = [];
99
+ var volume = bibField(entry, 'volume');
100
+ var issue = bibField(entry, 'number');
101
+ var pages = bibField(entry, 'pages').replace(/--/g, '\u2013');
102
+ if (volume) meta.push('vol. ' + escapeHtml(volume));
103
+ if (issue) meta.push('no. ' + escapeHtml(issue));
104
+ if (pages) meta.push('pp. ' + escapeHtml(pages));
105
+ if (meta.length) parts.push(meta.join(', ') + ',');
106
+ if (year) parts.push(escapeHtml(year) + '.');
107
+ } else if (type === 'techreport') {
108
+ if (author) parts.push(author + ',');
109
+ if (title) parts.push('"' + escapeHtml(title) + ',"');
110
+ var institution = bibField(entry, 'institution');
111
+ if (institution) parts.push(escapeHtml(institution) + ',');
112
+ if (year) parts.push(escapeHtml(year) + '.');
113
+ } else {
114
+ if (author) parts.push(author + ',');
115
+ if (title) parts.push('"' + escapeHtml(title) + ',"');
116
+ var howpublished = bibField(entry, 'howpublished');
117
+ if (howpublished) parts.push(escapeHtml(howpublished) + ',');
118
+ if (year) parts.push(escapeHtml(year) + '.');
119
+ }
120
+
121
+ var note = bibField(entry, 'note');
122
+ if (note) parts.push(escapeHtml(note) + '.');
123
+
124
+ var text = parts.join(' ');
125
+ if (url) {
126
+ text += ' [Online]. Available: ' + escapeHtml(url);
127
+ }
128
+ return text;
129
+ }
130
+
131
+ function scholarCiteHtml(key, number, bibIndex) {
132
+ if (!bibIndex || !bibIndex[key]) {
133
+ return "<sup class='citation-sup cite-missing' title='Bibliography entry &#39;" +
134
+ escapeAttr(key) + "&#39; not found'>[" + escapeHtml(key) + '?]</sup>';
135
+ }
136
+ // Single-quoted attrs so a cite can sit inside a double-quoted include attribute.
137
+ return "<sup class='citation-sup'><a href='#" + escapeAttr(key) + "' class='citation'>[" + number + ']</a></sup>';
138
+ }
139
+
140
+ function preprocessScholarCites(markdown, bibIndex) {
141
+ var citedKeys = [];
142
+ var keyToNumber = {};
143
+ var text = String(markdown || '').replace(/\{%-?\s*cite\s+([^%\s]+)[\s\S]*?-?%\}/g, function (_, rawKey) {
144
+ var key = String(rawKey || '').trim();
145
+ if (!key) return '';
146
+ if (!Object.prototype.hasOwnProperty.call(keyToNumber, key)) {
147
+ citedKeys.push(key);
148
+ keyToNumber[key] = citedKeys.length;
149
+ }
150
+ return scholarCiteHtml(key, keyToNumber[key], bibIndex);
151
+ });
152
+ return { text: text, citedKeys: citedKeys, keyToNumber: keyToNumber };
153
+ }
154
+
155
+ function referencesHeading(lang) {
156
+ var code = String(lang || '').toLowerCase();
157
+ if (code.indexOf('pt') === 0) return 'Referências';
158
+ return 'References';
159
+ }
160
+
161
+ function buildReferencesSection(citedKeys, bibIndex, lang) {
162
+ if (!citedKeys.length) return '';
163
+ var items = citedKeys.map(function (key, index) {
164
+ var number = index + 1;
165
+ var entry = bibIndex && bibIndex[key];
166
+ var body = entry ? formatIeeeEntry(entry, number) : escapeHtml(key) + ' (missing bibliography entry)';
167
+ return '<li><span id="' + escapeAttr(key) + '">[' + number + '] ' + body + '</span></li>';
168
+ }).join('');
169
+ return [
170
+ '<div class="article-references">',
171
+ '<h2 class="section-title">', escapeHtml(referencesHeading(lang)), '</h2>',
172
+ '<ol class="bibliography">', items, '</ol>',
173
+ '</div>'
174
+ ].join('');
175
+ }
176
+
177
+ function enhanceReferencesHtml(html) {
178
+ var root = document.createElement('div');
179
+ root.innerHTML = String(html || '');
180
+ root.querySelectorAll('.article-references .bibliography li').forEach(function (li) {
181
+ li.innerHTML = li.innerHTML.replace(/^(<(?:sup|span)\b[^>]*>)\[[0-9]+\]\s*/, '$1');
182
+ li.innerHTML = li.innerHTML.replace(
183
+ /(Available(?:\s+at)?):\s*(https?:\/\/[^\s<"]+)([.,;)\]]*)/g,
184
+ '$1: <a href="$2" target="_blank" rel="noopener noreferrer">$2</a>$3'
185
+ );
186
+ });
187
+ return root.innerHTML;
188
+ }
189
+
190
+ {% endraw %}
@@ -0,0 +1,122 @@
1
+ {% raw %}
2
+ var xciteIndex = null;
3
+ var xciteIndexPromise = null;
4
+
5
+ function normalizePathname(pathname) {
6
+ var path = String(pathname || '');
7
+ if (!path || path === '/') return '/';
8
+ return path.replace(/\/+$/, '');
9
+ }
10
+
11
+ function slugFromCleanPath(pathname, prefixes) {
12
+ var path = normalizePathname(pathname);
13
+ for (var i = 0; i < prefixes.length; i++) {
14
+ var prefix = prefixes[i];
15
+ var re = new RegExp('^' + prefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '/([^/]+)$');
16
+ var match = path.match(re);
17
+ if (match) return decodeURIComponent(match[1]);
18
+ }
19
+ return null;
20
+ }
21
+
22
+ function contentSlug(param) {
23
+ var params = new URLSearchParams(window.location.search);
24
+ var fromQuery = params.get(param);
25
+ if (fromQuery) return fromQuery;
26
+
27
+ var path = window.location.pathname;
28
+ if (param === 'article') return slugFromCleanPath(path, ['/articles']);
29
+ if (param === 'post') return slugFromCleanPath(path, ['/posts', '/blog']);
30
+ if (param === 'resource') return slugFromCleanPath(path, ['/resources']);
31
+ if (param === 'product') return slugFromCleanPath(path, ['/products']);
32
+ if (param === 'project') return slugFromCleanPath(path, ['/projects']);
33
+ return null;
34
+ }
35
+
36
+ /* Expand a registry detail pattern (`/articles/:slug/`) for a slug. */
37
+ function detailUrl(pattern, slug) {
38
+ var value = String(pattern || '');
39
+ if (!value) return '#';
40
+ return value.split(':slug').join(encodeURIComponent(slug));
41
+ }
42
+
43
+ /* Read a detail slug from the current path using a registry detail pattern. */
44
+ function slugFromDetailPattern(pathname, pattern) {
45
+ var value = String(pattern || '');
46
+ var marker = value.indexOf(':slug');
47
+ if (marker === -1) return null;
48
+ var prefix = normalizePathname(value.slice(0, marker));
49
+ if (!prefix || prefix === '/') return null;
50
+ return slugFromCleanPath(pathname, [prefix]);
51
+ }
52
+
53
+ function articleUrl(slug) {
54
+ return detailUrl('/articles/:slug/', slug);
55
+ }
56
+
57
+ function postUrl(slug) {
58
+ return detailUrl('/posts/:slug/', slug);
59
+ }
60
+
61
+ function productUrl(slug) {
62
+ return detailUrl('/products/:slug/', slug);
63
+ }
64
+
65
+ function projectUrl(slug) {
66
+ return detailUrl('/projects/:slug/', slug);
67
+ }
68
+
69
+ function resourceUrl(slug) {
70
+ return detailUrl('/resources/:slug/', slug);
71
+ }
72
+
73
+ function xciteUrl(item) {
74
+ if (item.url) return item.url;
75
+ var slug = item.slug || '';
76
+ var type = item.type || item.collection || '';
77
+ if (type === 'article' || type === 'articles') return articleUrl(slug);
78
+ if (type === 'post' || type === 'posts') return postUrl(slug);
79
+ if (type === 'product' || type === 'products') return productUrl(slug);
80
+ if (type === 'project' || type === 'projects') return projectUrl(slug);
81
+ if (type === 'resource' || type === 'resources') return resourceUrl(slug);
82
+ return '#';
83
+ }
84
+
85
+ function xciteLabel(item) {
86
+ if (item.title) return item.title;
87
+ var fm = item.front_matter || {};
88
+ return fm.title || fm.name || fm.product || fm.project || item.slug || '';
89
+ }
90
+
91
+ function xciteHtml(key, index) {
92
+ var item = index[key];
93
+ if (!item) return '<span class="xcite-missing" title="Internal reference \'' + escapeAttr(key) + '\' not found">[' + escapeHtml(key) + '?]</span>';
94
+ return '<a href="' + escapeAttr(xciteUrl(item)) + '" class="xcite-ref" title="' + escapeAttr(xciteLabel(item)) + '">' + escapeHtml(xciteLabel(item)) + '</a>';
95
+ }
96
+
97
+ function ensureXciteIndex() {
98
+ if (xciteIndex) return Promise.resolve(xciteIndex);
99
+ if (!xciteIndexPromise) {
100
+ xciteIndexPromise = loadJson('data/writing_index.json').then(function (entries) {
101
+ var index = {};
102
+ (entries || []).forEach(function (item) {
103
+ var key = item && item.key;
104
+ if (key) index[key] = item;
105
+ });
106
+ xciteIndex = index;
107
+ return index;
108
+ }).catch(function (error) {
109
+ xciteIndexPromise = null;
110
+ throw error;
111
+ });
112
+ }
113
+ return xciteIndexPromise;
114
+ }
115
+
116
+ function resolveXcitePlaceholders(html, index) {
117
+ return String(html || '').replace(/%%CONTENT_RUNTIME_XCITE_([^%]+)%%/g, function (_, key) {
118
+ return xciteHtml(key, index);
119
+ });
120
+ }
121
+
122
+ {% endraw %}