diff --git a/404.html b/404.html index 93521769..874e6fb5 100644 --- a/404.html +++ b/404.html @@ -5,7 +5,7 @@ Page Not Found | Spec-Up-T - + diff --git a/assets/js/2be7da73.20674fd1.js b/assets/js/2be7da73.20674fd1.js deleted file mode 100644 index 7718861c..00000000 --- a/assets/js/2be7da73.20674fd1.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkmy_website=self.webpackChunkmy_website||[]).push([[192],{8232:(e,t,i)=>{i.r(t),i.d(t,{assets:()=>p,contentTitle:()=>a,default:()=>d,frontMatter:()=>s,metadata:()=>c,toc:()=>r});var n=i(4848),o=i(8453);const s={sidebar_position:16},a="Q & A",c={id:"q-and-a",title:"Q & A",description:"Questions and answers about Spec-Up-T.",source:"@site/docs/q-and-a.md",sourceDirName:".",slug:"/q-and-a",permalink:"/spec-up-t-website/docs/q-and-a",draft:!1,unlisted:!1,editUrl:"https://github.com/blockchainbird/spec-up-t-website/tree/main/docs/q-and-a.md",tags:[],version:"current",sidebarPosition:16,frontMatter:{sidebar_position:16},sidebar:"tutorialSidebar",previous:{title:"Spec-Up-T demo site",permalink:"/spec-up-t-website/docs/spec-up-t-demo-site"},next:{title:"How it came to be",permalink:"/spec-up-t-website/docs/how-it-came-to-be"}},p={},r=[{value:"When I use Spec-Up-T do I get all the updates of Spec-Up too?",id:"when-i-use-spec-up-t-do-i-get-all-the-updates-of-spec-up-too",level:2},{value:"Can't we wait with the split up until because it might mess up thing for people curating the documents?",id:"cant-we-wait-with-the-split-up-until-because-it-might-mess-up-thing-for-people-curating-the-documents",level:2},{value:"How to get the original Spec-Up?",id:"how-to-get-the-original-spec-up",level:2},{value:"Where to find Spec-Up-T?",id:"where-to-find-spec-up-t",level:2},{value:"Why do I need to put commands on the command line?",id:"why-do-i-need-to-put-commands-on-the-command-line",level:2},{value:"What is the command for help?",id:"what-is-the-command-for-help",level:2},{value:"Why does Spec-Up-T look so complicated?",id:"why-does-spec-up-t-look-so-complicated",level:2},{value:"For who is Spec-Up-T?",id:"for-who-is-spec-up-t",level:2},{value:"Do you have a how-to video to get started with Spec-Up-T?",id:"do-you-have-a-how-to-video-to-get-started-with-spec-up-t",level:2},{value:"Where can I find the motivation of this move to create the Spec-Up bolt on "Spec-Up-T"?",id:"where-can-i-find-the-motivation-of-this-move-to-create-the-spec-up-bolt-on-spec-up-t",level:2},{value:"Why doesn't the Spec-Up-T repo generate a github.io-served specification itself?",id:"why-doesnt-the-spec-up-t-repo-generate-a-githubio-served-specification-itself",level:2},{value:"How to integrate Spec-Up-T in other systems",id:"how-to-integrate-spec-up-t-in-other-systems",level:2},{value:"No",id:"no",level:3},{value:"Yes",id:"yes",level:3}];function h(e){const t={a:"a",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,o.R)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(t.h1,{id:"q--a",children:"Q & A"}),"\n",(0,n.jsx)(t.p,{children:"Questions and answers about Spec-Up-T."}),"\n",(0,n.jsxs)(t.h2,{id:"when-i-use-spec-up-t-do-i-get-all-the-updates-of-spec-up-too",children:["When I use ",(0,n.jsx)(t.em,{children:"Spec-Up-T"})," do I get all the updates of ",(0,n.jsx)(t.em,{children:"Spec-Up"})," too?"]}),"\n",(0,n.jsxs)(t.p,{children:["Yes. The administrator team behind Spec-Up-T will keep ",(0,n.jsx)(t.a,{href:"https://github.com/decentralized-identity/spec-up",children:"Spec-Up of DIF"})," as a strict subset of code and features."]}),"\n",(0,n.jsx)(t.h2,{id:"cant-we-wait-with-the-split-up-until-because-it-might-mess-up-thing-for-people-curating-the-documents",children:"Can't we wait with the split up until because it might mess up thing for people curating the documents?"}),"\n",(0,n.jsx)(t.p,{children:"Splitting Spec-Up content over files is not an issue for people working on the content and looking at the github.io pages of the specification. It won't affect them. They see the same generated one-page document as a result. The index.html only has enhanced features. They can offer PRs as they always could."}),"\n",(0,n.jsxs)(t.h2,{id:"how-to-get-the-original-spec-up",children:["How to get the original ",(0,n.jsx)(t.em,{children:"Spec-Up"}),"?"]}),"\n",(0,n.jsxs)(t.p,{children:["I don't want ",(0,n.jsx)(t.em,{children:"Spec-Up-T"}),", I want the original ",(0,n.jsx)(t.em,{children:"Spec-Up"}),", but then with their improvements to be able to xref, and keep track of history etc. Is this possible?"]}),"\n",(0,n.jsxs)(t.p,{children:["Some improvements have been incorporated into Spec-Up. Spec-Up will remain a subset of Spec-Up-T. The extensions you will find only in Spec-Up-T are listed in the ",(0,n.jsx)(t.a,{href:"intro#extension",children:"introduction"}),"."]}),"\n",(0,n.jsx)(t.h2,{id:"where-to-find-spec-up-t",children:"Where to find Spec-Up-T?"}),"\n",(0,n.jsxs)(t.ul,{children:["\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:["Spec-Up-T is a github.com repo under Blockchainbird user: ",(0,n.jsx)(t.a,{href:"https://github.com/blockchainbird/spec-up-t",children:"https://github.com/blockchainbird/spec-up-t"}),". You can find the source code there."]}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:[(0,n.jsx)(t.strong,{children:"BEWARE / ATTENTION !!"})," The repo Spec-Up-T ",(0,n.jsx)(t.strong,{children:"DOES NOT generate an example specification on github.io"}),". DIF Spec-Up does generate one, but we don't. This has moved to the Spec-Up-T installer, see ",(0,n.jsx)(t.a,{href:"/spec-up-t-website/docs/admins-guide#installation",children:"the installation section in the admins guide"})]}),"\n"]}),"\n"]}),"\n",(0,n.jsx)(t.h2,{id:"why-do-i-need-to-put-commands-on-the-command-line",children:"Why do I need to put commands on the command line?"}),"\n",(0,n.jsx)(t.p,{children:"Brief answer: because Spec-Up-T is based on NPM packaging and version control."}),"\n",(0,n.jsx)(t.p,{children:"To understand why more thoroughly: Spec-Up-T is team-work tooling based on NPM, git versioning and (automated) github deployment. Therefore participants incept and maintain local version of specifications on their computer, manage updates to and fro github.com and generate local test and finally production sites (github actions github.io site).\nWith this type of creation and collegial management of versions and updates come commands on the command line."}),"\n",(0,n.jsx)(t.h2,{id:"what-is-the-command-for-help",children:"What is the command for help?"}),"\n",(0,n.jsx)(t.p,{children:"TODO: npx Spec-Up-T --help gives all commands I can give."}),"\n",(0,n.jsx)(t.h2,{id:"why-does-spec-up-t-look-so-complicated",children:"Why does Spec-Up-T look so complicated?"}),"\n",(0,n.jsx)(t.p,{children:"Spec-Up was simple, Spec-Up-T looks complicated, why?"}),"\n",(0,n.jsx)(t.p,{children:'Spec-Up is a subset of Spec-Up-T. The expansion "T" complicates the handling of term definitions, - references and external references (xrefs) of term in other repo\'s glossaries.\nToIP added functionality as well: diff tooling, search bar, and navigation aids.'}),"\n",(0,n.jsx)(t.p,{children:"On the other hand, Spec-Up-T is installable via just a single command:"}),"\n",(0,n.jsx)(t.pre,{children:(0,n.jsx)(t.code,{children:"$ npx create-spec-up-t my-spec-up-t-website\n"})}),"\n",(0,n.jsx)(t.h2,{id:"for-who-is-spec-up-t",children:"For who is Spec-Up-T?"}),"\n",(0,n.jsxs)(t.p,{children:["The ",(0,n.jsx)(t.strong,{children:"repo, command-line tools and the Docusaurus User guide is for Authors, Curators and Administrators"})," of repo's that use Spec-Up-T to run there specification effort in text, images, terms & definitions, etc."]}),"\n",(0,n.jsxs)(t.p,{children:["The ",(0,n.jsx)(t.strong,{children:"resulting github.io site is intended for any user"})," interested in the content of the specification."]}),"\n",(0,n.jsx)(t.h2,{id:"do-you-have-a-how-to-video-to-get-started-with-spec-up-t",children:"Do you have a how-to video to get started with Spec-Up-T?"}),"\n",(0,n.jsxs)(t.p,{children:["Yes. Find it here: ",(0,n.jsx)(t.a,{href:"/spec-up-t-website/docs/admins-guide#short-video",children:"Instruction starter package"})]}),"\n",(0,n.jsx)(t.h2,{id:"where-can-i-find-the-motivation-of-this-move-to-create-the-spec-up-bolt-on-spec-up-t",children:'Where can I find the motivation of this move to create the Spec-Up bolt on "Spec-Up-T"?'}),"\n",(0,n.jsxs)(t.p,{children:["Our enhancement proposal and git governance strategy is here: ",(0,n.jsx)(t.a,{href:"https://hackmd.io/s1TEBBluQBSL10ZT5yRVPw",children:"https://hackmd.io/s1TEBBluQBSL10ZT5yRVPw"})]}),"\n",(0,n.jsx)(t.h2,{id:"why-doesnt-the-spec-up-t-repo-generate-a-githubio-served-specification-itself",children:"Why doesn't the Spec-Up-T repo generate a github.io-served specification itself?"}),"\n",(0,n.jsx)(t.p,{children:"The repo Spec-Up-T doesn't generate an example specification on github.io. because it's not the purpose of this repo. Your example site will pop up when \u201cspec-up-t\u201d is installed in node_modules of spec-up-t-starterpack when you run npm install."}),"\n",(0,n.jsx)(t.h2,{id:"how-to-integrate-spec-up-t-in-other-systems",children:"How to integrate Spec-Up-T in other systems"}),"\n",(0,n.jsx)(t.p,{children:"We already have a Docusaurus (or Jekyll, etc) site. Is it possible to have a Spec-Up-T specification inside this site?"}),"\n",(0,n.jsx)(t.p,{children:"Yes and No."}),"\n",(0,n.jsx)(t.h3,{id:"no",children:"No"}),"\n",(0,n.jsx)(t.p,{children:"Installing Spec-Up-T inside Docusaurus (or Jekyll, etc) is possible, however it is not recommended practice to have nested node_modules directories. Docusaurus (or Jekyll, etc) have their own node_modules directory. You can install Spec-Up-T in a sub directory in which it will get it's own node_modules directory after installation but this is not recommended."}),"\n",(0,n.jsx)(t.h3,{id:"yes",children:"Yes"}),"\n",(0,n.jsx)(t.p,{children:"You can install Spec-Up-T in it's own separate directory in your file system and generate the index.html file. This file can be moved around freely and live in it's own directory, for example in the /static directory of your Docusaurus site. You can rename index.html to foo.html or whatever you like. You could link to this file from other files in your Docusaurus site."}),"\n",(0,n.jsx)(t.p,{children:"However, the Spec-Up-T file (a one-page website) will have it's own menu and have no connection to your Docusaurus site."})]})}function d(e={}){const{wrapper:t}={...(0,o.R)(),...e.components};return t?(0,n.jsx)(t,{...e,children:(0,n.jsx)(h,{...e})}):h(e)}},8453:(e,t,i)=>{i.d(t,{R:()=>a,x:()=>c});var n=i(6540);const o={},s=n.createContext(o);function a(e){const t=n.useContext(s);return n.useMemo((function(){return"function"==typeof e?e(t):{...t,...e}}),[t,e])}function c(e){let t;return t=e.disableParentContext?"function"==typeof e.components?e.components(o):e.components||o:a(e.components),n.createElement(s.Provider,{value:t},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/2be7da73.6c27dffc.js b/assets/js/2be7da73.6c27dffc.js new file mode 100644 index 00000000..1b63ec7a --- /dev/null +++ b/assets/js/2be7da73.6c27dffc.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkmy_website=self.webpackChunkmy_website||[]).push([[192],{8232:(e,t,i)=>{i.r(t),i.d(t,{assets:()=>p,contentTitle:()=>a,default:()=>d,frontMatter:()=>s,metadata:()=>c,toc:()=>r});var n=i(4848),o=i(8453);const s={sidebar_position:16},a="Q & A",c={id:"q-and-a",title:"Q & A",description:"Questions and answers about Spec-Up-T.",source:"@site/docs/q-and-a.md",sourceDirName:".",slug:"/q-and-a",permalink:"/spec-up-t-website/docs/q-and-a",draft:!1,unlisted:!1,editUrl:"https://github.com/blockchainbird/spec-up-t-website/tree/main/docs/q-and-a.md",tags:[],version:"current",sidebarPosition:16,frontMatter:{sidebar_position:16},sidebar:"tutorialSidebar",previous:{title:"Spec-Up-T demo site",permalink:"/spec-up-t-website/docs/spec-up-t-demo-site"},next:{title:"How it came to be",permalink:"/spec-up-t-website/docs/how-it-came-to-be"}},p={},r=[{value:"When I use Spec-Up-T do I get all the updates of Spec-Up too?",id:"when-i-use-spec-up-t-do-i-get-all-the-updates-of-spec-up-too",level:2},{value:"Can't we wait with the split up until because it might mess up thing for people curating the documents?",id:"cant-we-wait-with-the-split-up-until-because-it-might-mess-up-thing-for-people-curating-the-documents",level:2},{value:"How to get the original Spec-Up?",id:"how-to-get-the-original-spec-up",level:2},{value:"Where to find Spec-Up-T?",id:"where-to-find-spec-up-t",level:2},{value:"Why do I need to put commands on the command line?",id:"why-do-i-need-to-put-commands-on-the-command-line",level:2},{value:"What is the command for help?",id:"what-is-the-command-for-help",level:2},{value:"Why does Spec-Up-T look so complicated?",id:"why-does-spec-up-t-look-so-complicated",level:2},{value:"For who is Spec-Up-T?",id:"for-who-is-spec-up-t",level:2},{value:"Do you have a how-to video to get started with Spec-Up-T?",id:"do-you-have-a-how-to-video-to-get-started-with-spec-up-t",level:2},{value:"Where can I find the motivation of this move to create the Spec-Up bolt on "Spec-Up-T"?",id:"where-can-i-find-the-motivation-of-this-move-to-create-the-spec-up-bolt-on-spec-up-t",level:2},{value:"Why doesn't the Spec-Up-T repo generate a github.io-served specification itself?",id:"why-doesnt-the-spec-up-t-repo-generate-a-githubio-served-specification-itself",level:2},{value:"How to integrate Spec-Up-T in other systems",id:"how-to-integrate-spec-up-t-in-other-systems",level:2},{value:"No",id:"no",level:3},{value:"Yes",id:"yes",level:3}];function h(e){const t={a:"a",admonition:"admonition",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",p:"p",pre:"pre",strong:"strong",...(0,o.R)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(t.h1,{id:"q--a",children:"Q & A"}),"\n",(0,n.jsx)(t.p,{children:"Questions and answers about Spec-Up-T."}),"\n",(0,n.jsxs)(t.h2,{id:"when-i-use-spec-up-t-do-i-get-all-the-updates-of-spec-up-too",children:["When I use ",(0,n.jsx)(t.em,{children:"Spec-Up-T"})," do I get all the updates of ",(0,n.jsx)(t.em,{children:"Spec-Up"})," too?"]}),"\n",(0,n.jsxs)(t.p,{children:["Yes. The administrator team behind Spec-Up-T will keep ",(0,n.jsx)(t.a,{href:"https://github.com/decentralized-identity/spec-up",children:"Spec-Up of DIF"})," as a strict subset of code and features."]}),"\n",(0,n.jsx)(t.h2,{id:"cant-we-wait-with-the-split-up-until-because-it-might-mess-up-thing-for-people-curating-the-documents",children:"Can't we wait with the split up until because it might mess up thing for people curating the documents?"}),"\n",(0,n.jsx)(t.p,{children:"Splitting Spec-Up content over files is not an issue for people working on the content and looking at the github.io pages of the specification. It won't affect them. They see the same generated one-page document as a result. The index.html only has enhanced features. They can offer PRs as they always could."}),"\n",(0,n.jsxs)(t.h2,{id:"how-to-get-the-original-spec-up",children:["How to get the original ",(0,n.jsx)(t.em,{children:"Spec-Up"}),"?"]}),"\n",(0,n.jsxs)(t.p,{children:["I don't want ",(0,n.jsx)(t.em,{children:"Spec-Up-T"}),", I want the original ",(0,n.jsx)(t.em,{children:"Spec-Up"}),", but then with their improvements to be able to xref, and keep track of history etc. Is this possible?"]}),"\n",(0,n.jsxs)(t.p,{children:["Some improvements have been incorporated into Spec-Up. Spec-Up will remain a subset of Spec-Up-T. The extensions you will find only in Spec-Up-T are listed in the ",(0,n.jsx)(t.a,{href:"intro#extension",children:"introduction"}),"."]}),"\n",(0,n.jsx)(t.h2,{id:"where-to-find-spec-up-t",children:"Where to find Spec-Up-T?"}),"\n",(0,n.jsxs)(t.p,{children:["Spec-Up-T is a github.com repo under Blockchainbird user: ",(0,n.jsx)(t.a,{href:"https://github.com/blockchainbird/spec-up-t",children:"https://github.com/blockchainbird/spec-up-t"}),". You can find the source code there."]}),"\n",(0,n.jsxs)(t.admonition,{type:"warning",children:[(0,n.jsxs)(t.p,{children:["Unlike the DIF Spec-Up repository, the Spec-Up-T repository ",(0,n.jsx)(t.strong,{children:"does not generate an example specification on github.io"}),"."]}),(0,n.jsxs)(t.p,{children:["This functionality has been moved to the Spec-Up-T ",(0,n.jsx)(t.em,{children:"installer"}),"."]}),(0,n.jsxs)(t.p,{children:["For more details, refer to ",(0,n.jsx)(t.a,{href:"/spec-up-t-website/docs/admins-guide#installation",children:"the installation section in the admin guide"}),"."]})]}),"\n",(0,n.jsx)(t.h2,{id:"why-do-i-need-to-put-commands-on-the-command-line",children:"Why do I need to put commands on the command line?"}),"\n",(0,n.jsx)(t.p,{children:"Brief answer: because Spec-Up-T is based on NPM packaging and version control."}),"\n",(0,n.jsx)(t.p,{children:"To understand why more thoroughly: Spec-Up-T is team-work tooling based on NPM, git versioning and (automated) github deployment. Therefore participants incept and maintain local version of specifications on their computer, manage updates to and fro github.com and generate local test and finally production sites (github actions github.io site).\nWith this type of creation and collegial management of versions and updates come commands on the command line."}),"\n",(0,n.jsx)(t.h2,{id:"what-is-the-command-for-help",children:"What is the command for help?"}),"\n",(0,n.jsx)(t.p,{children:"TODO: npx Spec-Up-T --help gives all commands I can give."}),"\n",(0,n.jsx)(t.h2,{id:"why-does-spec-up-t-look-so-complicated",children:"Why does Spec-Up-T look so complicated?"}),"\n",(0,n.jsx)(t.p,{children:"Spec-Up was simple, Spec-Up-T looks complicated, why?"}),"\n",(0,n.jsx)(t.p,{children:'Spec-Up is a subset of Spec-Up-T. The expansion "T" complicates the handling of term definitions, - references and external references (xrefs) of term in other repo\'s glossaries.\nToIP added functionality as well: diff tooling, search bar, and navigation aids.'}),"\n",(0,n.jsx)(t.p,{children:"On the other hand, Spec-Up-T is installable via just a single command:"}),"\n",(0,n.jsx)(t.pre,{children:(0,n.jsx)(t.code,{children:"$ npx create-spec-up-t my-spec-up-t-website\n"})}),"\n",(0,n.jsx)(t.h2,{id:"for-who-is-spec-up-t",children:"For who is Spec-Up-T?"}),"\n",(0,n.jsxs)(t.p,{children:["The ",(0,n.jsx)(t.strong,{children:"repo, command-line tools and the Docusaurus User guide is for Authors, Curators and Administrators"})," of repo's that use Spec-Up-T to run there specification effort in text, images, terms & definitions, etc."]}),"\n",(0,n.jsxs)(t.p,{children:["The ",(0,n.jsx)(t.strong,{children:"resulting github.io site is intended for any user"})," interested in the content of the specification."]}),"\n",(0,n.jsx)(t.h2,{id:"do-you-have-a-how-to-video-to-get-started-with-spec-up-t",children:"Do you have a how-to video to get started with Spec-Up-T?"}),"\n",(0,n.jsxs)(t.p,{children:["Yes. Find it here: ",(0,n.jsx)(t.a,{href:"/spec-up-t-website/docs/admins-guide#short-video",children:"Instruction starter package"})]}),"\n",(0,n.jsx)(t.h2,{id:"where-can-i-find-the-motivation-of-this-move-to-create-the-spec-up-bolt-on-spec-up-t",children:'Where can I find the motivation of this move to create the Spec-Up bolt on "Spec-Up-T"?'}),"\n",(0,n.jsxs)(t.p,{children:["Our enhancement proposal and git governance strategy is here: ",(0,n.jsx)(t.a,{href:"https://hackmd.io/s1TEBBluQBSL10ZT5yRVPw",children:"https://hackmd.io/s1TEBBluQBSL10ZT5yRVPw"})]}),"\n",(0,n.jsx)(t.h2,{id:"why-doesnt-the-spec-up-t-repo-generate-a-githubio-served-specification-itself",children:"Why doesn't the Spec-Up-T repo generate a github.io-served specification itself?"}),"\n",(0,n.jsx)(t.p,{children:"The repo Spec-Up-T doesn't generate an example specification on github.io. because it's not the purpose of this repo. Your example site will pop up when \u201cspec-up-t\u201d is installed in node_modules of spec-up-t-starterpack when you run npm install."}),"\n",(0,n.jsx)(t.h2,{id:"how-to-integrate-spec-up-t-in-other-systems",children:"How to integrate Spec-Up-T in other systems"}),"\n",(0,n.jsx)(t.p,{children:"We already have a Docusaurus (or Jekyll, etc) site. Is it possible to have a Spec-Up-T specification inside this site?"}),"\n",(0,n.jsx)(t.p,{children:"Yes and No."}),"\n",(0,n.jsx)(t.h3,{id:"no",children:"No"}),"\n",(0,n.jsx)(t.p,{children:"Installing Spec-Up-T inside Docusaurus (or Jekyll, etc) is possible, however it is not recommended practice to have nested node_modules directories. Docusaurus (or Jekyll, etc) have their own node_modules directory. You can install Spec-Up-T in a sub directory in which it will get it's own node_modules directory after installation but this is not recommended."}),"\n",(0,n.jsx)(t.h3,{id:"yes",children:"Yes"}),"\n",(0,n.jsx)(t.p,{children:"You can install Spec-Up-T in it's own separate directory in your file system and generate the index.html file. This file can be moved around freely and live in it's own directory, for example in the /static directory of your Docusaurus site. You can rename index.html to foo.html or whatever you like. You could link to this file from other files in your Docusaurus site."}),"\n",(0,n.jsx)(t.p,{children:"However, the Spec-Up-T file (a one-page website) will have it's own menu and have no connection to your Docusaurus site."})]})}function d(e={}){const{wrapper:t}={...(0,o.R)(),...e.components};return t?(0,n.jsx)(t,{...e,children:(0,n.jsx)(h,{...e})}):h(e)}},8453:(e,t,i)=>{i.d(t,{R:()=>a,x:()=>c});var n=i(6540);const o={},s=n.createContext(o);function a(e){const t=n.useContext(s);return n.useMemo((function(){return"function"==typeof e?e(t):{...t,...e}}),[t,e])}function c(e){let t;return t=e.disableParentContext?"function"==typeof e.components?e.components(o):e.components||o:a(e.components),n.createElement(s.Provider,{value:t},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/runtime~main.3be65331.js b/assets/js/runtime~main.d31b5940.js similarity index 98% rename from assets/js/runtime~main.3be65331.js rename to assets/js/runtime~main.d31b5940.js index be680c3a..042d3c84 100644 --- a/assets/js/runtime~main.3be65331.js +++ b/assets/js/runtime~main.d31b5940.js @@ -1 +1 @@ -(()=>{"use strict";var e,a,t,r,c,f={},d={};function o(e){var a=d[e];if(void 0!==a)return a.exports;var t=d[e]={id:e,loaded:!1,exports:{}};return f[e].call(t.exports,t,t.exports,o),t.loaded=!0,t.exports}o.m=f,o.c=d,e=[],o.O=(a,t,r,c)=>{if(!t){var f=1/0;for(i=0;i=c)&&Object.keys(o.O).every((e=>o.O[e](t[n])))?t.splice(n--,1):(d=!1,c0&&e[i-1][2]>c;i--)e[i]=e[i-1];e[i]=[t,r,c]},o.n=e=>{var a=e&&e.__esModule?()=>e.default:()=>e;return o.d(a,{a:a}),a},t=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,o.t=function(e,r){if(1&r&&(e=this(e)),8&r)return e;if("object"==typeof e&&e){if(4&r&&e.__esModule)return e;if(16&r&&"function"==typeof e.then)return e}var c=Object.create(null);o.r(c);var f={};a=a||[null,t({}),t([]),t(t)];for(var d=2&r&&e;"object"==typeof d&&!~a.indexOf(d);d=t(d))Object.getOwnPropertyNames(d).forEach((a=>f[a]=()=>e[a]));return f.default=()=>e,o.d(c,f),c},o.d=(e,a)=>{for(var t in a)o.o(a,t)&&!o.o(e,t)&&Object.defineProperty(e,t,{enumerable:!0,get:a[t]})},o.f={},o.e=e=>Promise.all(Object.keys(o.f).reduce(((a,t)=>(o.f[t](e,a),a)),[])),o.u=e=>"assets/js/"+({13:"9d9f8394",48:"a94703ab",51:"e747ec83",61:"1f391b9e",66:"acc96f77",98:"a7bd4aaa",134:"393be207",157:"e0c4e08d",167:"9428579a",192:"2be7da73",235:"a7456010",249:"ccc49370",301:"7352707a",345:"680248e1",373:"1e2342fa",392:"3dc49084",398:"e2490c2d",401:"17896441",418:"f049f840",422:"738e0f00",431:"ecd4a663",449:"fdea42e3",452:"f70ccc90",472:"814f3328",481:"4741e212",494:"9f502ea7",509:"c4a0550b",538:"8edce930",548:"3e8d065b",561:"08e3fca0",634:"c4f5d8e4",643:"a6aa9e1f",647:"5e95c892",685:"4d95055f",711:"9e4087bc",715:"f49b999f",742:"aba21aa0",858:"36994c47",865:"166ee7c9",871:"8050fd0a",903:"acecf23e",969:"14eb3368",976:"0e384e19"}[e]||e)+"."+{13:"f63b4fe8",48:"bbf09f2c",51:"21f0ebc3",61:"bea182c1",66:"a1b8f2c2",98:"e61c3b7b",134:"6a78c15a",157:"ad62afba",167:"41526df7",192:"20674fd1",235:"d27e4924",237:"f4fbea9d",249:"589d1dc3",261:"12b02a80",300:"8dc279ed",301:"5897ffe2",345:"a5ff402e",373:"413d2147",392:"8790a5ee",398:"c6c2267c",401:"247000cb",418:"03bd21f7",422:"082cebe7",431:"df229edb",449:"1af32f0c",452:"6dc6ebc4",472:"d1eea19c",481:"3e923282",494:"c3f2e84e",509:"6aa12fab",538:"14c1a3ba",548:"7012bfbd",561:"99217aae",634:"a72359e0",643:"e4f15be8",647:"7afa0510",685:"396cc1d9",711:"d3f8ed7f",715:"8c0d6d53",742:"bddde0da",858:"f2ddbf25",865:"859e5059",871:"6ee49d6c",903:"d383a297",969:"c0626e6f",976:"af553f1c"}[e]+".js",o.miniCssF=e=>{},o.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),o.o=(e,a)=>Object.prototype.hasOwnProperty.call(e,a),r={},c="my-website:",o.l=(e,a,t,f)=>{if(r[e])r[e].push(a);else{var d,n;if(void 0!==t)for(var b=document.getElementsByTagName("script"),i=0;i{d.onerror=d.onload=null,clearTimeout(s);var c=r[e];if(delete r[e],d.parentNode&&d.parentNode.removeChild(d),c&&c.forEach((e=>e(t))),a)return a(t)},s=setTimeout(l.bind(null,void 0,{type:"timeout",target:d}),12e4);d.onerror=l.bind(null,d.onerror),d.onload=l.bind(null,d.onload),n&&document.head.appendChild(d)}},o.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},o.p="/spec-up-t-website/",o.gca=function(e){return e={17896441:"401","9d9f8394":"13",a94703ab:"48",e747ec83:"51","1f391b9e":"61",acc96f77:"66",a7bd4aaa:"98","393be207":"134",e0c4e08d:"157","9428579a":"167","2be7da73":"192",a7456010:"235",ccc49370:"249","7352707a":"301","680248e1":"345","1e2342fa":"373","3dc49084":"392",e2490c2d:"398",f049f840:"418","738e0f00":"422",ecd4a663:"431",fdea42e3:"449",f70ccc90:"452","814f3328":"472","4741e212":"481","9f502ea7":"494",c4a0550b:"509","8edce930":"538","3e8d065b":"548","08e3fca0":"561",c4f5d8e4:"634",a6aa9e1f:"643","5e95c892":"647","4d95055f":"685","9e4087bc":"711",f49b999f:"715",aba21aa0:"742","36994c47":"858","166ee7c9":"865","8050fd0a":"871",acecf23e:"903","14eb3368":"969","0e384e19":"976"}[e]||e,o.p+o.u(e)},(()=>{var e={354:0,869:0};o.f.j=(a,t)=>{var r=o.o(e,a)?e[a]:void 0;if(0!==r)if(r)t.push(r[2]);else if(/^(354|869)$/.test(a))e[a]=0;else{var c=new Promise(((t,c)=>r=e[a]=[t,c]));t.push(r[2]=c);var f=o.p+o.u(a),d=new Error;o.l(f,(t=>{if(o.o(e,a)&&(0!==(r=e[a])&&(e[a]=void 0),r)){var c=t&&("load"===t.type?"missing":t.type),f=t&&t.target&&t.target.src;d.message="Loading chunk "+a+" failed.\n("+c+": "+f+")",d.name="ChunkLoadError",d.type=c,d.request=f,r[1](d)}}),"chunk-"+a,a)}},o.O.j=a=>0===e[a];var a=(a,t)=>{var r,c,f=t[0],d=t[1],n=t[2],b=0;if(f.some((a=>0!==e[a]))){for(r in d)o.o(d,r)&&(o.m[r]=d[r]);if(n)var i=n(o)}for(a&&a(t);b{"use strict";var e,a,t,r,c,f={},d={};function o(e){var a=d[e];if(void 0!==a)return a.exports;var t=d[e]={id:e,loaded:!1,exports:{}};return f[e].call(t.exports,t,t.exports,o),t.loaded=!0,t.exports}o.m=f,o.c=d,e=[],o.O=(a,t,r,c)=>{if(!t){var f=1/0;for(i=0;i=c)&&Object.keys(o.O).every((e=>o.O[e](t[n])))?t.splice(n--,1):(d=!1,c0&&e[i-1][2]>c;i--)e[i]=e[i-1];e[i]=[t,r,c]},o.n=e=>{var a=e&&e.__esModule?()=>e.default:()=>e;return o.d(a,{a:a}),a},t=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,o.t=function(e,r){if(1&r&&(e=this(e)),8&r)return e;if("object"==typeof e&&e){if(4&r&&e.__esModule)return e;if(16&r&&"function"==typeof e.then)return e}var c=Object.create(null);o.r(c);var f={};a=a||[null,t({}),t([]),t(t)];for(var d=2&r&&e;"object"==typeof d&&!~a.indexOf(d);d=t(d))Object.getOwnPropertyNames(d).forEach((a=>f[a]=()=>e[a]));return f.default=()=>e,o.d(c,f),c},o.d=(e,a)=>{for(var t in a)o.o(a,t)&&!o.o(e,t)&&Object.defineProperty(e,t,{enumerable:!0,get:a[t]})},o.f={},o.e=e=>Promise.all(Object.keys(o.f).reduce(((a,t)=>(o.f[t](e,a),a)),[])),o.u=e=>"assets/js/"+({13:"9d9f8394",48:"a94703ab",51:"e747ec83",61:"1f391b9e",66:"acc96f77",98:"a7bd4aaa",134:"393be207",157:"e0c4e08d",167:"9428579a",192:"2be7da73",235:"a7456010",249:"ccc49370",301:"7352707a",345:"680248e1",373:"1e2342fa",392:"3dc49084",398:"e2490c2d",401:"17896441",418:"f049f840",422:"738e0f00",431:"ecd4a663",449:"fdea42e3",452:"f70ccc90",472:"814f3328",481:"4741e212",494:"9f502ea7",509:"c4a0550b",538:"8edce930",548:"3e8d065b",561:"08e3fca0",634:"c4f5d8e4",643:"a6aa9e1f",647:"5e95c892",685:"4d95055f",711:"9e4087bc",715:"f49b999f",742:"aba21aa0",858:"36994c47",865:"166ee7c9",871:"8050fd0a",903:"acecf23e",969:"14eb3368",976:"0e384e19"}[e]||e)+"."+{13:"f63b4fe8",48:"bbf09f2c",51:"21f0ebc3",61:"bea182c1",66:"a1b8f2c2",98:"e61c3b7b",134:"6a78c15a",157:"ad62afba",167:"41526df7",192:"6c27dffc",235:"d27e4924",237:"f4fbea9d",249:"589d1dc3",261:"12b02a80",300:"8dc279ed",301:"5897ffe2",345:"a5ff402e",373:"413d2147",392:"8790a5ee",398:"c6c2267c",401:"247000cb",418:"03bd21f7",422:"082cebe7",431:"df229edb",449:"1af32f0c",452:"6dc6ebc4",472:"d1eea19c",481:"3e923282",494:"c3f2e84e",509:"6aa12fab",538:"14c1a3ba",548:"7012bfbd",561:"99217aae",634:"a72359e0",643:"e4f15be8",647:"7afa0510",685:"396cc1d9",711:"d3f8ed7f",715:"8c0d6d53",742:"bddde0da",858:"f2ddbf25",865:"859e5059",871:"6ee49d6c",903:"d383a297",969:"c0626e6f",976:"af553f1c"}[e]+".js",o.miniCssF=e=>{},o.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),o.o=(e,a)=>Object.prototype.hasOwnProperty.call(e,a),r={},c="my-website:",o.l=(e,a,t,f)=>{if(r[e])r[e].push(a);else{var d,n;if(void 0!==t)for(var b=document.getElementsByTagName("script"),i=0;i{d.onerror=d.onload=null,clearTimeout(s);var c=r[e];if(delete r[e],d.parentNode&&d.parentNode.removeChild(d),c&&c.forEach((e=>e(t))),a)return a(t)},s=setTimeout(l.bind(null,void 0,{type:"timeout",target:d}),12e4);d.onerror=l.bind(null,d.onerror),d.onload=l.bind(null,d.onload),n&&document.head.appendChild(d)}},o.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},o.p="/spec-up-t-website/",o.gca=function(e){return e={17896441:"401","9d9f8394":"13",a94703ab:"48",e747ec83:"51","1f391b9e":"61",acc96f77:"66",a7bd4aaa:"98","393be207":"134",e0c4e08d:"157","9428579a":"167","2be7da73":"192",a7456010:"235",ccc49370:"249","7352707a":"301","680248e1":"345","1e2342fa":"373","3dc49084":"392",e2490c2d:"398",f049f840:"418","738e0f00":"422",ecd4a663:"431",fdea42e3:"449",f70ccc90:"452","814f3328":"472","4741e212":"481","9f502ea7":"494",c4a0550b:"509","8edce930":"538","3e8d065b":"548","08e3fca0":"561",c4f5d8e4:"634",a6aa9e1f:"643","5e95c892":"647","4d95055f":"685","9e4087bc":"711",f49b999f:"715",aba21aa0:"742","36994c47":"858","166ee7c9":"865","8050fd0a":"871",acecf23e:"903","14eb3368":"969","0e384e19":"976"}[e]||e,o.p+o.u(e)},(()=>{var e={354:0,869:0};o.f.j=(a,t)=>{var r=o.o(e,a)?e[a]:void 0;if(0!==r)if(r)t.push(r[2]);else if(/^(354|869)$/.test(a))e[a]=0;else{var c=new Promise(((t,c)=>r=e[a]=[t,c]));t.push(r[2]=c);var f=o.p+o.u(a),d=new Error;o.l(f,(t=>{if(o.o(e,a)&&(0!==(r=e[a])&&(e[a]=void 0),r)){var c=t&&("load"===t.type?"missing":t.type),f=t&&t.target&&t.target.src;d.message="Loading chunk "+a+" failed.\n("+c+": "+f+")",d.name="ChunkLoadError",d.type=c,d.request=f,r[1](d)}}),"chunk-"+a,a)}},o.O.j=a=>0===e[a];var a=(a,t)=>{var r,c,f=t[0],d=t[1],n=t[2],b=0;if(f.some((a=>0!==e[a]))){for(r in d)o.o(d,r)&&(o.m[r]=d[r]);if(n)var i=n(o)}for(a&&a(t);b Archive | Spec-Up-T - + diff --git a/blog/index.html b/blog/index.html index 111bbdb2..324d155d 100644 --- a/blog/index.html +++ b/blog/index.html @@ -5,7 +5,7 @@ Blog | Spec-Up-T - + diff --git a/blog/welcome/index.html b/blog/welcome/index.html index 61919c67..db45653b 100644 --- a/blog/welcome/index.html +++ b/blog/welcome/index.html @@ -5,7 +5,7 @@ Welcome | Spec-Up-T - + diff --git a/docs/admins-guide/index.html b/docs/admins-guide/index.html index 61ed5e59..5d9c2ce6 100644 --- a/docs/admins-guide/index.html +++ b/docs/admins-guide/index.html @@ -5,7 +5,7 @@ Admins Guide | Spec-Up-T - + diff --git a/docs/category/content-authors-guide/index.html b/docs/category/content-authors-guide/index.html index 1931a474..d87df158 100644 --- a/docs/category/content-authors-guide/index.html +++ b/docs/category/content-authors-guide/index.html @@ -5,7 +5,7 @@ Content Authors Guide | Spec-Up-T - + diff --git a/docs/category/curators-guide/index.html b/docs/category/curators-guide/index.html index 298be344..a5b65a33 100644 --- a/docs/category/curators-guide/index.html +++ b/docs/category/curators-guide/index.html @@ -5,7 +5,7 @@ Curators Guide | Spec-Up-T - + diff --git a/docs/category/glossary-maintainers-guide/index.html b/docs/category/glossary-maintainers-guide/index.html index 4c5900a8..f535d2eb 100644 --- a/docs/category/glossary-maintainers-guide/index.html +++ b/docs/category/glossary-maintainers-guide/index.html @@ -5,7 +5,7 @@ Glossary Maintainers Guide | Spec-Up-T - + diff --git a/docs/category/readers-guide/index.html b/docs/category/readers-guide/index.html index 4a895fed..707a21ed 100644 --- a/docs/category/readers-guide/index.html +++ b/docs/category/readers-guide/index.html @@ -5,7 +5,7 @@ Readers Guide | Spec-Up-T - + diff --git a/docs/category/terminology-author-guide/index.html b/docs/category/terminology-author-guide/index.html index 00a665c5..62a06aec 100644 --- a/docs/category/terminology-author-guide/index.html +++ b/docs/category/terminology-author-guide/index.html @@ -5,7 +5,7 @@ Terminology Author Guide | Spec-Up-T - + diff --git a/docs/content-authors-guide/introduction/index.html b/docs/content-authors-guide/introduction/index.html index 6d10d5c5..62b9db25 100644 --- a/docs/content-authors-guide/introduction/index.html +++ b/docs/content-authors-guide/introduction/index.html @@ -5,7 +5,7 @@ Content Authors Guide | Spec-Up-T - + diff --git a/docs/curators-guide/introduction/index.html b/docs/curators-guide/introduction/index.html index e679e33f..9b9ed9b3 100644 --- a/docs/curators-guide/introduction/index.html +++ b/docs/curators-guide/introduction/index.html @@ -5,7 +5,7 @@ Curators Guide | Spec-Up-T - + diff --git a/docs/developers-guide/index.html b/docs/developers-guide/index.html index 6b8704a8..03499b3e 100644 --- a/docs/developers-guide/index.html +++ b/docs/developers-guide/index.html @@ -5,7 +5,7 @@ Developers Guide | Spec-Up-T - + diff --git a/docs/general-guide/index.html b/docs/general-guide/index.html index 5ce168a9..efad609d 100644 --- a/docs/general-guide/index.html +++ b/docs/general-guide/index.html @@ -5,7 +5,7 @@ General Guide | Spec-Up-T - + diff --git a/docs/glossary-maintainers-guide/introduction/index.html b/docs/glossary-maintainers-guide/introduction/index.html index bf27cd2e..17b90a92 100644 --- a/docs/glossary-maintainers-guide/introduction/index.html +++ b/docs/glossary-maintainers-guide/introduction/index.html @@ -5,7 +5,7 @@ Glossary Maintainers Guide | Spec-Up-T - + diff --git a/docs/glossary/index.html b/docs/glossary/index.html index 7548cc7b..3f3338de 100644 --- a/docs/glossary/index.html +++ b/docs/glossary/index.html @@ -5,7 +5,7 @@ Glossary | Spec-Up-T - + diff --git a/docs/how-it-came-to-be/index.html b/docs/how-it-came-to-be/index.html index e3186be3..71e342af 100644 --- a/docs/how-it-came-to-be/index.html +++ b/docs/how-it-came-to-be/index.html @@ -5,7 +5,7 @@ How it came to be | Spec-Up-T - + diff --git a/docs/intro/index.html b/docs/intro/index.html index b6ccac3c..7bb0ac51 100644 --- a/docs/intro/index.html +++ b/docs/intro/index.html @@ -5,7 +5,7 @@ Introduction | Spec-Up-T - + diff --git a/docs/q-and-a/index.html b/docs/q-and-a/index.html index 1ece053b..01980ad0 100644 --- a/docs/q-and-a/index.html +++ b/docs/q-and-a/index.html @@ -5,7 +5,7 @@ Q & A | Spec-Up-T - + @@ -19,21 +19,15 @@

introduction.

Where to find Spec-Up-T?​

- +
warning

Unlike the DIF Spec-Up repository, the Spec-Up-T repository does not generate an example specification on github.io.

This functionality has been moved to the Spec-Up-T installer.

For more details, refer to the installation section in the admin guide.

Why do I need to put commands on the command line?​

Brief answer: because Spec-Up-T is based on NPM packaging and version control.

To understand why more thoroughly: Spec-Up-T is team-work tooling based on NPM, git versioning and (automated) github deployment. Therefore participants incept and maintain local version of specifications on their computer, manage updates to and fro github.com and generate local test and finally production sites (github actions github.io site). With this type of creation and collegial management of versions and updates come commands on the command line.

What is the command for help?​

TODO: npx Spec-Up-T --help gives all commands I can give.

-

Why does Spec-Up-T look so complicated?​

+

Why does Spec-Up-T look so complicated?​

Spec-Up was simple, Spec-Up-T looks complicated, why?

Spec-Up is a subset of Spec-Up-T. The expansion "T" complicates the handling of term definitions, - references and external references (xrefs) of term in other repo's glossaries. ToIP added functionality as well: diff tooling, search bar, and navigation aids.

diff --git a/docs/readers-guide/introduction/index.html b/docs/readers-guide/introduction/index.html index 913192e2..a951733e 100644 --- a/docs/readers-guide/introduction/index.html +++ b/docs/readers-guide/introduction/index.html @@ -5,7 +5,7 @@ Readers Guide | Spec-Up-T - + diff --git a/docs/spec-up-t-demo-site/index.html b/docs/spec-up-t-demo-site/index.html index 8ef08231..321989b4 100644 --- a/docs/spec-up-t-demo-site/index.html +++ b/docs/spec-up-t-demo-site/index.html @@ -5,7 +5,7 @@ Spec-Up-T demo site | Spec-Up-T - + diff --git a/docs/terminology-authors-guide/external-term-references/index.html b/docs/terminology-authors-guide/external-term-references/index.html index c0cc1a4a..4018d5ec 100644 --- a/docs/terminology-authors-guide/external-term-references/index.html +++ b/docs/terminology-authors-guide/external-term-references/index.html @@ -5,7 +5,7 @@ External Term References | Spec-Up-T - + diff --git a/docs/terminology-authors-guide/introduction/index.html b/docs/terminology-authors-guide/introduction/index.html index a868983b..954a6511 100644 --- a/docs/terminology-authors-guide/introduction/index.html +++ b/docs/terminology-authors-guide/introduction/index.html @@ -5,7 +5,7 @@ Terminology Authors Guide | Spec-Up-T - + diff --git a/docs/terminology-authors-guide/term-references/index.html b/docs/terminology-authors-guide/term-references/index.html index 73106d0b..427ad825 100644 --- a/docs/terminology-authors-guide/term-references/index.html +++ b/docs/terminology-authors-guide/term-references/index.html @@ -5,7 +5,7 @@ Term References | Spec-Up-T - + diff --git a/docs/this-site-maintainers/index.html b/docs/this-site-maintainers/index.html index 53d8b094..7287522e 100644 --- a/docs/this-site-maintainers/index.html +++ b/docs/this-site-maintainers/index.html @@ -5,7 +5,7 @@ Maintaining this site | Spec-Up-T - + diff --git a/docs/troubleshooting/index.html b/docs/troubleshooting/index.html index f60f8f6b..90ad764b 100644 --- a/docs/troubleshooting/index.html +++ b/docs/troubleshooting/index.html @@ -5,7 +5,7 @@ Troubleshooting | Spec-Up-T - + diff --git a/index.html b/index.html index f52c4826..bf7409e5 100644 --- a/index.html +++ b/index.html @@ -5,7 +5,7 @@ Spec-Up-T | Spec-Up-T - + diff --git a/markdown-page/index.html b/markdown-page/index.html index 1825dd17..19810fb4 100644 --- a/markdown-page/index.html +++ b/markdown-page/index.html @@ -5,7 +5,7 @@ Markdown page example | Spec-Up-T - + diff --git a/spec-up-t-demo/docs/index.html b/spec-up-t-demo/docs/index.html index 1159a6ca..27925b2f 100644 --- a/spec-up-t-demo/docs/index.html +++ b/spec-up-t-demo/docs/index.html @@ -1944,6 +1944,9 @@

§ Spec-Up-T Demo

§ Intro

+

This is a default Spec-Up-T installation. Find information on the Spec-Up-T + documentation website.

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla