30:[] 2e:{"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"},{"id":281,"value":"md`\\`\\`\\`js\nimport {getCurrentPinnedName} from '${await getCurrentPinnedName()}'\n\\`\\`\\``","pinned":true,"hidden":false,"mode":"ojs"},{"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"},{"id":4,"value":"function getCurrentLocalPath() {\n return html``.pathname;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":136,"value":"function getCurrentPath() {\n return formatPath(getCurrentName());\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":5,"value":"function getCurrentName() {\n return getCurrentLocalPath().replace(/^\\/(d\\/)?/, '');\n}","pinned":false,"hidden":false,"mode":"ojs"},{"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"},{"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"},{"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"},{"id":118,"value":"md`---\n## Other Notebooks\nFunctions for retrieving information about any notebooks.\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":252,"value":"viewof preview_name = {\n const submit = html``;\n const input = html``;\n const view = html`

${input} ${submit}`;\n input.oninput = e => e.stopPropagation();\n submit.onclick = () => { view.value = input.value; view.dispatchEvent(new Event('input')) };\n view.value = input.value;\n return view;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"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"},{"id":35,"value":"function formatLocalPath(name, version = null) {\n return '/' + (name.match(/^@/) ? name : 'd/' + name) + (version ? '@' + version : '');\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":27,"value":"function formatPath(name, version = null) {\n return `https://${domain}${formatLocalPath(name, version)}`;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":13,"value":"function formatSourcePath(name, version = null) {\n return `https://${apiDomain}${formatLocalPath(name, version)}.js`;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":358,"value":"function formatName(name, version = null) {\n return name + (version ? '@' + version : '');\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":316,"value":"function formatId(id, version = null) {\n return id + (version ? '@' + version : '');\n}","pinned":false,"hidden":false,"mode":"ojs"},{"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"},{"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"},{"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"},{"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"},{"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"},{"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"},{"id":47,"value":"md`---`","pinned":false,"hidden":false,"mode":"ojs"},{"id":29,"value":"domain = 'observablehq.com'","pinned":false,"hidden":false,"mode":"ojs"},{"id":39,"value":"apiDomain = 'api.observablehq.com'","pinned":false,"hidden":false,"mode":"ojs"},{"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"}],"files":"$W30","stdlib":"1","titling":"auto"}