| "use strict";(self.webpackChunkwebsite_next=self.webpackChunkwebsite_next||[]).push([[59508],{15680:(e,t,n)=>{n.d(t,{xA:()=>c,yg:()=>d});var r=n(96540);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function o(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function i(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?o(Object(n),!0).forEach((function(t){a(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):o(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,r,a=function(e,t){if(null==e)return{};var n,r,a={},o=Object.keys(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var s=r.createContext({}),p=function(e){var t=r.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):i(i({},t),e)),n},c=function(e){var t=p(e.components);return r.createElement(s.Provider,{value:t},e.children)},u="mdxType",y={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},g=r.forwardRef((function(e,t){var n=e.components,a=e.mdxType,o=e.originalType,s=e.parentName,c=l(e,["components","mdxType","originalType","parentName"]),u=p(n),g=a,d=u["".concat(s,".").concat(g)]||u[g]||y[g]||o;return n?r.createElement(d,i(i({ref:t},c),{},{components:n})):r.createElement(d,i({ref:t},c))}));function d(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=n.length,i=new Array(o);i[0]=g;var l={};for(var s in t)hasOwnProperty.call(t,s)&&(l[s]=t[s]);l.originalType=e,l[u]="string"==typeof e?e:a,i[1]=l;for(var p=2;p<o;p++)i[p]=n[p];return r.createElement.apply(null,i)}return r.createElement.apply(null,n)}g.displayName="MDXCreateElement"},67071:(e,t,n)=>{n.r(t),n.d(t,{assets:()=>s,contentTitle:()=>i,default:()=>y,frontMatter:()=>o,metadata:()=>l,toc:()=>p});var r=n(58168),a=(n(96540),n(15680));const o={},i="Previewing content",l={unversionedId:"document-preview",id:"document-preview",title:"Previewing content",description:"This guide explains why and how to preview Pulsar content locally with detailed steps and various examples.",source:"@site/contribute/document-preview.md",sourceDirName:".",slug:"/document-preview",permalink:"/contribute/document-preview",draft:!1,editUrl:"https://github.com/apache/pulsar-site/edit/main/contribute/document-preview.md",tags:[],version:"current",lastUpdatedBy:"github-actions[bot]",lastUpdatedAt:1713836078,formattedLastUpdatedAt:"Apr 23, 2024",frontMatter:{},sidebar:"sidebarDevelopment",previous:{title:"Introduction",permalink:"/contribute/site-intro"},next:{title:"Writing syntax",permalink:"/contribute/document-syntax"}},s={},p=[{value:"Why preview changes locally?",id:"why-preview-changes-locally",level:2},{value:"How to preview changes locally?",id:"how-to-preview-changes-locally",level:2},{value:"Prerequisites",id:"prerequisites",level:3},{value:"Preview changes",id:"preview-changes",level:3},{value:"Stop preview",id:"stop-preview",level:3}],c={toc:p},u="wrapper";function y(e){let{components:t,...o}=e;return(0,a.yg)(u,(0,r.A)({},c,o,{components:t,mdxType:"MDXLayout"}),(0,a.yg)("h1",{id:"previewing-content"},"Previewing content"),(0,a.yg)("p",null,"This guide explains why and how to preview Pulsar content locally with detailed steps and various examples."),(0,a.yg)("h2",{id:"why-preview-changes-locally"},"Why preview changes locally?"),(0,a.yg)("p",null,"It is ",(0,a.yg)("strong",{parentName:"p"},"required")," to preview your changes locally and attach the preview screenshots in your PR description. It brings many benefits, including but not limited to:"),(0,a.yg)("ul",null,(0,a.yg)("li",{parentName:"ul"},"You can test your writings. It's a way to check whether you use the correct ",(0,a.yg)("a",{parentName:"li",href:"/contribute/document-syntax"},"syntax"),". You ",(0,a.yg)("strong",{parentName:"li"},"must ensure")," docs can be compiled and published correctly."),(0,a.yg)("li",{parentName:"ul"},"You can get your PR merged more quickly. Reviewers know your changes clearly and can speed up the review process.")),(0,a.yg)("h2",{id:"how-to-preview-changes-locally"},"How to preview changes locally?"),(0,a.yg)("p",null,"Pulsar documentation is built using ",(0,a.yg)("a",{parentName:"p",href:"https://docusaurus.io/"},"Docusaurus"),". To preview your changes as you edit the files, you can run a local development server that serves your website and reflect the latest changes."),(0,a.yg)("h3",{id:"prerequisites"},"Prerequisites"),(0,a.yg)("p",null,"To verify docs are built correctly before submitting a contribution, you should set up your local environment to build and display the docs locally."),(0,a.yg)("ul",null,(0,a.yg)("li",{parentName:"ul"},"Node >= 20.0.0 (latest LTS recommended)"),(0,a.yg)("li",{parentName:"ul"},"Corepack enabled (",(0,a.yg)("inlineCode",{parentName:"li"},"corepack enable"),")"),(0,a.yg)("li",{parentName:"ul"},"Although you can use Linux, macOS, or Windows to build locally the Pulsar documentation, macOS is the preferred build environment as it offers the most complete support for documentation building.")),(0,a.yg)("p",null,"Installing prerequisites with ",(0,a.yg)("a",{parentName:"p",href:"https://brew.sh/"},"homebrew")," on MacOS or Linux:"),(0,a.yg)("pre",null,(0,a.yg)("code",{parentName:"pre",className:"language-shell"},"brew install node\ncorepack enable\n")),(0,a.yg)("h3",{id:"preview-changes"},"Preview changes"),(0,a.yg)("p",null,"Pulsar website changes refer to all the changes made to the Pulsar website, including but not limited to the following pages:"),(0,a.yg)("ul",null,(0,a.yg)("li",{parentName:"ul"},(0,a.yg)("a",{parentName:"li",href:"pathname:///docs"},"User documents")),(0,a.yg)("li",{parentName:"ul"},(0,a.yg)("a",{parentName:"li",href:"/contribute/"},"Contribution guide")),(0,a.yg)("li",{parentName:"ul"},(0,a.yg)("a",{parentName:"li",href:"pathname:///release-notes/"},"Release notes")),(0,a.yg)("li",{parentName:"ul"},(0,a.yg)("a",{parentName:"li",href:"pathname:///ecosystem"},"Ecosystem page")),(0,a.yg)("li",{parentName:"ul"},(0,a.yg)("a",{parentName:"li",href:"pathname:///case-studies"},"Case studies")),(0,a.yg)("li",{parentName:"ul"},"...")),(0,a.yg)("p",null,"Follow these steps to preview the website changes."),(0,a.yg)("ol",null,(0,a.yg)("li",{parentName:"ol"},(0,a.yg)("p",{parentName:"li"},"Change to the working directory:"),(0,a.yg)("pre",{parentName:"li"},(0,a.yg)("code",{parentName:"pre",className:"language-bash"},"cd pulsar-site/\n"))),(0,a.yg)("li",{parentName:"ol"},(0,a.yg)("p",{parentName:"li"},"Run the following command to preview changes:"),(0,a.yg)("pre",{parentName:"li"},(0,a.yg)("code",{parentName:"pre",className:"language-bash"},"# Preview changes on master\n./preview.sh current\n\n# preview changes on a specific version\n./preview.sh 2.10.x\n\n# preview changes on multiple versions\n./preview.sh 2.10.x 2.9.x ...\n")))),(0,a.yg)("p",null,"By default, a browser window will open at ",(0,a.yg)("a",{parentName:"p",href:"http://localhost:3000"},"http://localhost:3000")," to show the changes:"),(0,a.yg)("p",null,(0,a.yg)("img",{alt:"alt_text",src:n(59655).A,width:"936",height:"678"})),(0,a.yg)("admonition",{type:"tip"},(0,a.yg)("p",{parentName:"admonition"},"When you click on ",(0,a.yg)("inlineCode",{parentName:"p"},"Docs"),", you are taken to the latest stable version (e.g., ",(0,a.yg)("inlineCode",{parentName:"p"},"http://localhost:3000/docs/2.10.x/"),"). If you want to preview changes on ",(0,a.yg)("inlineCode",{parentName:"p"},"master"),", change the URL to ",(0,a.yg)("inlineCode",{parentName:"p"},"http://localhost:3000/docs/next"))),(0,a.yg)("h3",{id:"stop-preview"},"Stop preview"),(0,a.yg)("p",null,"Switch to your command-line interface and press ",(0,a.yg)("strong",{parentName:"p"},"Control+C"),"."))}y.isMDXComponent=!0},59655:(e,t,n)=>{n.d(t,{A:()=>r});const r=n.p+"assets/images/website-preview-3e284d8b7c2292bcb606955218a65a23.png"}}]); |