Hello world!

`);\n});\n```\n\nExample: @andreterron/openable_handler\n\n### 2. Wrap your HTML string\n\n```ts\nimport { modifyHtmlString } from \"https://esm.town/v/andreterron/codeOnValTown?v=50\";\nimport { html } from \"https://esm.town/v/stevekrouse/html?v=5\";\n\nexport default async (req: Request): Promise => {\n return html(modifyHtmlString(`

Hello world!

`));\n};\n```\n\nExample: @andreterron/openable_html\n\n### Other ways\n\nWe made sure this was very modular, so you can also add the ribbon using these methods:\n\n- Get the element string directly: @andreterron/codeOnVT_ribbonElement\n- Modify an HTTP Response: @andreterron/codeOnVT_modifyResponse\n- Use `.pipeThrough` to append to a stream: @andreterron/InjectCodeOnValTownStream\n\n## Customization\n\n### Linking to the val\n\nThese functions infer the val using the call stack or the request URL. If the inference isn't working, or if you want to ensure it links to a specific val, pass the `val` argument:\n\n- `modifyFetchHandler(handler, {val: { handle: \"andre\", name: \"foo\" }})`\n- `modifyHtmlString(\"...\", {val: { handle: \"andre\", name: \"foo\" }})`\n\n### Styling\n\nYou can set the style parameter to a css string to customize the ribbon. Check out [github-fork-ribbon-css](https://github.com/simonwhitaker/github-fork-ribbon-css?tab=readme-ov-file#styling) to learn more about how to style the element.\n\n- `modifyFetchHandler(handler, {style: \".github-fork-ribbon:before { background-color: #333; }\"})`\n- `modifyHtmlString(\"...\", {style: \".github-fork-ribbon:before { background-color: #333; }\"})`\n\nHere's how you can hide the ribbon on small screens:\n\n```ts\nmodifyFetchHandler(handler, {style: `@media (max-width: 768px) {\n .github-fork-ribbon {\n display: none !important;\n }\n}`})\n```\n\n## To-dos\n\n- [ ] Let users customize the ribbon. Some ideas are the text, color or placement.","valType","script","currentVersion","6018d552-615d-11ef-ae8c-de64eea55b61","legacyPrivate","code","import { modifyResponse } from \"https://esm.town/v/andreterron/codeOnVT_modifyResponse?v=9\";\nimport { ribbonElement } from \"https://esm.town/v/andreterron/codeOnVT_ribbonElement?v=7\";\nimport { inferRequestVal } from \"https://esm.town/v/andreterron/inferRequestVal?v=2\";\nimport { rootValRef } from \"https://esm.town/v/andreterron/rootValRef?v=3\";\nimport { ValRef } from \"https://esm.town/v/andreterron/ValRef?v=1\";\n\n/**\n * @param bodyText HTML string that will be used to inject the element.\n * @param val Define which val should open. Defaults to the root reference\n */\nexport function modifyHtmlString(\n bodyText: string,\n { val, style }: { val?: ValRef; style?: string } = {},\n) {\n val = val?.handle && val?.name ? val : rootValRef();\n\n if (!val) {\n console.error(\"Failed to infer val. Please set the options.val parameter to the desired `{ handle, name }`\");\n return bodyText;\n }\n\n const element = ribbonElement({ val, style });\n\n const bodyIndex = bodyText.lastIndexOf(\"\");\n const htmlIndex = bodyText.lastIndexOf(\"\");\n\n // Append the element before or . Get the last occurrence of each\n // and use whichever one comes first.\n if (bodyIndex !== -1 && (htmlIndex === -1 || bodyIndex < htmlIndex)) {\n return bodyText.slice(0, bodyIndex) + element + bodyText.slice(bodyIndex);\n } else if (htmlIndex !== -1) {\n return bodyText.slice(0, htmlIndex) + element + bodyText.slice(htmlIndex);\n } else {\n return bodyText + element;\n }\n}\n\n/**\n * @param handler Fetch handler\n * @param val Define which val should open\n */\nexport function modifyFetchHandler(\n handler: (req: Request) => Response | Promise,\n { val, style }: { val?: ValRef; style?: string } = {},\n): (req: Request) => Promise {\n return async (req: Request): Promise => {\n const res = await handler(req);\n\n val = val?.handle && val?.name ? val : inferRequestVal(req);\n return modifyResponse(res, { val, style });\n };\n}\n\nexport default modifyFetchHandler;",["D",1724423914384],"version","currentUserHasLiked","referenceCount","dependencyCount",5,"commentCount","prCount","mergedPr",{"_96":97,"_101":102},"forkedVal",{"_94":151,"_96":152,"_124":125,"_140":153,"_154":-5},"8981f9f4-4a98-11ef-a97a-de64eea55b61","andreterron",51,"prDisabledHint","interval","description","Code on Val Town Adds a \"Code on Val Town\" ribbon to your page. This lets your website visitors navigate to the code behind it. This uses github-fork-ribbon-css under the hood. Usage Here are 2 different ways to add the \"Code on Val Town\" ribbon: 1. Wrap your fetch handler (recommended) import { modifyFetchHandler } from \"https://esm.town/v/andreterron/codeOnValTown?v=50\";\nimport { html } from \"https://esm.town/v/stevekrouse/html?v=5\";\n\nexport default modifyFetchHandler(async (req: Request): Promise => {\n return html(`

Hello world!

`);\n}); Example: @andreterron/openable_handler 2. Wrap your HTML string import { modifyHtmlString } from \"https://esm.town/v/andreterron/codeOnValTown?v=50\";\nimport { html } from \"https://esm.town/v/stevekrouse/html?v=5\";\n\nexport default async (req: Request): Promise => {\n return html(modifyHtmlString(`

Hello world!

`));\n}; Example: @andreterron/openable_html Other ways We made sure this was very modular, so you can also add the ribbon using these methods: Get the element string directly: @andreterron/codeOnVT_ribbonElement Modify an HTTP Response: @andreterron/codeOnVT_modifyResponse Use .pipeThrough to append to a stream: @andreterron/InjectCodeOnValTownStream Customization Linking to the val These functions infer the val using the call stack or the request URL. If the inference isn't working, or if you want to ensure it links to a specific val, pass the val argument: modifyFetchHandler(handler, {val: { handle: \"andre\", name: \"foo\" }}) modifyHtmlString(\"...\", {val: { handle: \"andre\", name: \"foo\" }}) Styling You can set the style parameter to a css string to customize the ribbon. Check out github-fork-ribbon-css to learn more about how to style the element. modifyFetchHandler(handler, {style: \".github-fork-ribbon:before { background-color: #333; }\"}) modifyHtmlString(\"...\", {style: \".github-fork-ribbon:before { background-color: #333; }\"}) Here's how you can hide the ribbon on small screens: modifyFetchHandler(handler, {style: `@media (max-width: 768px) {\n .github-fork-ribbon {\n display: none !important;\n }\n}`}) To-dos [ ] Let users customize the ribbon. Some ideas are the text, color or placement.","latestEvaluation","slug","Serizon/codeOnValTown","versions",[163],{"_98":164,"_140":31,"_165":166},["D",1724423914384],"n","1","hasNext","routes/_app","actionData","errors"]