2e:null 2f:["$","title",null,{"children":"Version Pinning for Notebooks | Bryan Gin-ge Chen | Observable"}] 34:T4be,viewof compareLink = { function makeInput(val) { const el = html``; el.oninput = e => e.stopPropagation(); return el; } let compare = params.get('compare'); if (compare) compare = compare .match(/(?:(?:observablehq\.com)?\/?compare\/)?([a-z0-9]+(?:@[0-9]+)?)\.\.\.([a-z0-9]+(?:@[0-9]+)?)/); const val = compare ? compare[1] : params.get('nb'); const val2 = compare ? compare[2] : params.get('nb2'); const submit = html``; const input1 = makeInput(val ? val : "@jashkenas/inputs"); const input2 = makeInput(val2 ? val2 : "@tmcw/inputs/2"); const view = html`

${input1} ${input2} ${submit}`; submit.onclick = () => { const match1 = nbMatch(input1.value); const match2 = nbMatch(input2.value); if (match1) input1.value = match1[1]; if (match2) input2.value = match2[1]; view.value = [input1.value, input2.value]; view.dispatchEvent(new Event('input')); }; const match1 = nbMatch(input1.value); const match2 = nbMatch(input2.value); if (match1) input1.value = match1[1]; if (match2) input2.value = match2[1]; view.value = [input1.value, input2.value]; return view; }35:[] 32:{"id":"266a02d4ca20abc2","slug":"version-pinning-for-notebooks","title":"Version Pinning for Notebooks","thumbnail":"564943dccc199a4b74a6cfa7a3491290a89d6e6a33e416912e29289636aa67a3","access_level":"public","create_time":"$D2018-11-24T05:41:45.472Z","update_time":"$D2019-03-13T02:38:08.229Z","view_time":null,"first_public_time":"$D2018-12-10T07:38:42.671Z","has_unpublished_edits":null,"fork":{"id":"55bed46f68a80641","slug":"notebook-data","title":"Version Pinning for Notebooks","owner":{"id":"898d35f8860c7f03","login":"mootari","name":"Fabian Iwand"}},"stars":2,"starred":false,"owner":{"type":"team","id":"d2fd23101beb2a61","login":"bryangingechen","name":"Bryan Gin-ge Chen","avatar_url":"https://avatars-next.observableusercontent.com/73f0dccc0b7fc5c845e6a52a58e01a2ae432cc529aaada0d10ab602137e603c0","tier":"starter_2024"},"version":469,"publish_version":469,"role":null,"authored":false,"authors":[{"type":"individual","id":"5c13a1a27cf52564","login":"bryangingechen","name":"Bryan Gin-ge Chen","avatar_url":"https://avatars-next.observableusercontent.com/73f0dccc0b7fc5c845e6a52a58e01a2ae432cc529aaada0d10ab602137e603c0","tier":null}],"members":[{"type":"individual","id":"5c13a1a27cf52564","login":"bryangingechen","name":"Bryan Gin-ge Chen","avatar_url":"https://avatars-next.observableusercontent.com/73f0dccc0b7fc5c845e6a52a58e01a2ae432cc529aaada0d10ab602137e603c0","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":1,"collection":{"id":"0e370c3a8bfed6b8","slug":"forks","title":"Forks","owner":{"id":"d2fd23101beb2a61","login":"bryangingechen","name":"Bryan Gin-ge Chen"}},"type":"notebook","body":{"title":"Version Pinning for Notebooks","cells":[{"id":0,"value":"md`# Version Pinning for Notebooks\nObservable supports version pinning by appending the version number to the notebook name or path.\n\nThese functions make it easier to look up the most recent version of notebooks, and to use pinned versions in your own documentation. Example:`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":281,"value":"md`\\`\\`\\`js\nimport {getCurrentPinnedName} from '${await getCurrentPinnedName()}'\n\\`\\`\\``","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":116,"value":"md`---\n## Current Notebook\nFunctions that can be used to obtain information about the currently viewed notebook. Metadata and the pinned name will be available once you have shared or published your notebook. Reload the page after publishing to see the updated version number.\n\n${dataTable([\n ['getCurrentLocalPath', getCurrentLocalPath()],\n ['getCurrentPath', getCurrentPath()],\n ['getCurrentName', getCurrentName()],\n ['getCurrentPinnedName', await getCurrentPinnedName()],\n ['getCurrentMetadata', await getCurrentMetadata()],\n ['getCurrentComparePath', await getCurrentComparePath(299)]\n])}\n\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":4,"value":"function getCurrentLocalPath() {\n return html``.pathname;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":136,"value":"function getCurrentPath() {\n return formatPath(getCurrentName());\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":5,"value":"function getCurrentName() {\n return getCurrentLocalPath().replace(/^\\/(d\\/)?/, '').replace(/\\/$/, '');\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":148,"value":"async function getCurrentPinnedName() {\n const data = await getCurrentMetadata();\n if(data && data.version) return formatName(getCurrentName(), data.version);\n return null;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":94,"value":"getCurrentMetadata = {\n let data;\n return async function getCurrentMetadata(refetch = false) {\n if(data === undefined || refetch) data = await getMetadata(getCurrentName());\n return data;\n }\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":325,"value":"async function getCurrentComparePath(version1 = null, version2 = null) {\n const data = await getMetadata(getCurrentName());\n if(data) return formatComparePath(data.id, version1, data.id, version2);\n return null;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":118,"value":"md`---\n## Other Notebooks\nFunctions for retrieving information about any notebooks. Below, you may input:\n- the full URL to the notebook, or\n- everything after \"\\`observablehq.com/\\`\", or\n- the alphanumeric code after \"\\`observablehq.com/d/\\`\"\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":252,"value":"viewof preview_name = {\n const val = params.get('nb');\n const submit = html``;\n const input = html``;\n const view = html`${input} ${submit}`;\n input.oninput = e => e.stopPropagation();\n submit.onclick = () => {\n const match = nbMatch(input.value);\n if (match) input.value = match[1];\n view.value = input.value;\n view.dispatchEvent(new Event('input'));\n };\n const match = nbMatch(input.value);\n if (match) input.value = match[1];\n view.value = input.value;\n return view;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":269,"value":"dataTable([\n ['formatLocalPath', formatLocalPath(preview_name)],\n ['formatPath', formatPath(preview_name)],\n ['formatSourcePath', formatSourcePath(preview_name)],\n ['getPinnedName', await getPinnedName(preview_name)],\n ['getPinnedPath', await getPinnedPath(preview_name)],\n ['getSource', await getSource(preview_name)],\n ['getMetadata', await getMetadata(preview_name)],\n])","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":415,"value":"$34","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":426,"value":"{\n const data1 = await getMetadata(compareLink[0]);\n const data2 = await getMetadata(compareLink[1]);\n const cp = (data1 && data2) ? formatComparePath(data1.id, data1.version, data2.id, data2.version) : null;\n\n return md`Pinned compare link: [\\`${cp ? cp : \"couldn't get notebook data\"}\\`](${cp ? cp : '#compareLink'})`\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":420,"value":"nbMatch = (inp) => inp.match(/(?:observablehq\\.com\\/)((@[A-Za-z0-9]+\\/[A-za-z0-9-]+(\\/[0-9]+)?)|(d\\/[A-za-z0-9]+))/)","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":35,"value":"function formatLocalPath(name, version = null) {\n return '/' + (name.match(/(^@)|(^d\\/)/) ? name : 'd/' + name) + (version !== null ? '@' + version : '');\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":27,"value":"function formatPath(name, version = null) {\n return `https://${domain}${formatLocalPath(name, version)}`;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":13,"value":"function formatSourcePath(name, version = null) {\n return `https://${apiDomain}${formatLocalPath(name, version)}.js`;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":358,"value":"function formatName(name, version = null) {\n return name + (version ? '@' + version : '');\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":316,"value":"function formatId(id, version = null) {\n return id + (version ? '@' + version : '');\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":304,"value":"function formatComparePath(id1, version1, id2, version2) {\n return `https://${domain}/compare/${formatId(id1, version1)}...${formatId(id2, version2)}`;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":153,"value":"async function getPinnedName(name) {\n const data = await getMetadata(name);\n if(data && data.version) return name + '@' + data.version;\n return null;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":127,"value":"async function getPinnedPath(name) {\n const data = await getMetadata(name);\n if(data && data.version) return formatPath(name, data.version);\n return null;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":303,"value":"async function getComparePath(name, version1 = null, version2 = null) {\n const data = await getMetadata(name);\n if(data) return formatComparePath(data.id, version1, data.id, version2);\n return null;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":58,"value":"async function getSource(name, version = null) {\n const path = formatSourcePath(name, version);\n try {\n const response = await fetch(path, {cache: version ? 'default' : 'no-cache'});\n return await response.text();\n }\n catch(e) { return null; } \n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":66,"value":"async function getMetadata(name, version = null) {\n const map = {\n 'URL': 'url',\n 'Title': 'title',\n 'Author': 'author',\n 'Version': 'version',\n 'Runtime version': 'runtimeVersion'\n };\n const source = await getSource(name, version);\n if(!source) return null;\n \n const frontmatter = source.match(/^(?:\\/\\/ .+?\\n)+/);\n const id = source.match(/^\\s+?id:\\s+?\"([^@\"]+)/m);\n if(!frontmatter || !id) return null;\n \n return frontmatter[0].split(/\\n/).reduce((data, s) => {\n const m = s.match(/^\\/\\/ ([^:]+?):\\s+?(.+?)$/);\n if(m && map.hasOwnProperty(m[1])) data[map[m[1]]] = m[2];\n return data;\n }, {id: id[1]});\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":47,"value":"md`---`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":458,"value":"params = new URLSearchParams(html``.search)","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":29,"value":"domain = 'observablehq.com'","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":39,"value":"apiDomain = 'api.observablehq.com'","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":180,"value":"function dataTable(rows) {\n const style = 'padding:.5em;vertical-align:top';\n const n = rows.map(([l,d]) => {\n const wrap = html`

`;\n wrap.textContent = JSON.stringify(d);\n return html`${l}${wrap}`;\n });\n return html`${n}`;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W35","stdlib":"1","titling":"auto"}} 33:"$32:body"