diff --git a/release-handbook/pdf_generation_guide.md b/release-handbook/pdf_generation_guide.md index b5294565b9..3e1caa58ff 100644 --- a/release-handbook/pdf_generation_guide.md +++ b/release-handbook/pdf_generation_guide.md @@ -31,7 +31,7 @@ Instructions for each case are listed in the sections below. 4. Select the **bash** option from the **+** drop-down menu in the terminal. 5. Paste the following command: ``` - npx docs-to-pdf --initialDocURLs="https://docs.zowe.org/stable/getting-started/overview,https://docs.zowe.org/stable/user-guide/install-overview,https://docs.zowe.org/stable/user-guide/zowe-getting-started-tutorial,https://docs.zowe.org/stable/extend/extend-zowe-overview,https://docs.zowe.org/stable/troubleshoot/troubleshooting,https://docs.zowe.org/stable/contribute/roadmap-contribute,https://docs.zowe.org/stable/appendix/zowe-cli-command-reference" --cssStyle=":root{--ifm-font-size-base: 80%;}" --contentSelector="article" --paginationSelector=".pagination-nav__link--next" --excludeSelectors=".no-pdf,.announcementBar_UUUQ,nav.navbar,.docSidebarContainer_3pwe,.docMainContainer_2pgU .col.col--3,footer.footer,.docItemContainer_2szM > .margin-vert--xl > .row > .col:first-child,.pagination-nav,.docsRating,.navbar__inner,.thin-scrollbar" --coverImage="https://docs.zowe.org/img/zowe-icon.png" --coverTitle="Zowe Documentation" --outputPDFFilename="static/zowe-docs.pdf" --protocolTimeout=1800000 + npx docs-to-pdf --initialDocURLs="https://docs.zowe.org/stable/whats-new/zowe-announcements,https://docs.zowe.org/stable/getting-started/overview,https://docs.zowe.org/stable/user-guide/install-overview,https://docs.zowe.org/stable/user-guide/zowe-getting-started-tutorial,https://docs.zowe.org/stable/extend/extend-zowe-overview,https://docs.zowe.org/stable/troubleshoot/troubleshooting,https://docs.zowe.org/stable/contribute/roadmap-contribute,https://docs.zowe.org/stable/appendix/zowe-cli-command-reference" --cssStyle=":root{--ifm-font-size-base: 80%;}" --contentSelector="article" --paginationSelector=".pagination-nav__link--next" --excludeSelectors=".no-pdf,.announcementBar_UUUQ,nav.navbar,.docSidebarContainer_3pwe,.docMainContainer_2pgU .col.col--3,footer.footer,.docItemContainer_2szM > .margin-vert--xl > .row > .col:first-child,.pagination-nav,.docsRating,.navbar__inner,.thin-scrollbar" --coverImage="https://docs.zowe.org/img/zowe-icon.png" --coverTitle="Zowe Documentation" --outputPDFFilename="static/zowe-docs.pdf" --protocolTimeout=1800000 ``` This command generates the PDF by using a script that fetches pages from https://docs.zowe.org and scans the content in each page to save it. @@ -46,7 +46,7 @@ Instructions for each case are listed in the sections below. Once the branches are merged, the PDF for the new release is published to the live site. -### Generating the PDF for a V1 patch release, or a previous release +### Generating the PDF for a previous release 1. Create a temporary branch based off the `master` branch. @@ -55,7 +55,7 @@ Instructions for each case are listed in the sections below. 4. Paste the following command, updating the version and patch numbers as necessary: ``` - npx docs-to-pdf --initialDocURLs="https://docs.zowe.org/v1.28.x/getting-started/overview,https://docs.zowe.org/v1.28.x/user-guide/install-overview,https://docs.zowe.org/v1.28.x/user-guide/zowe-getting-started-tutorial,https://docs.zowe.org/v1.28.x/extend/extend-zowe-overview,https://docs.zowe.org/v1.28.x/troubleshoot/troubleshooting,https://docs.zowe.org/v1.28.x/contribute/roadmap-contribute,https://docs.zowe.org/v1.28.x/appendix/zowe-cli-command-reference" --cssStyle=":root{--ifm-font-size-base: 80%;}" --contentSelector="article" --paginationSelector=".pagination-nav__link--next" --excludeSelectors=".no-pdf,.announcementBar_UUUQ,nav.navbar,.docSidebarContainer_3pwe,.docMainContainer_2pgU .col.col--3,footer.footer,.docItemContainer_2szM > .margin-vert--xl > .row > .col:first-child,.pagination-nav,.docsRating,.navbar__inner,.thin-scrollbar" --coverImage="https://docs.zowe.org/img/zowe-icon.png" --coverTitle="Zowe Version 1.28.x Documentation" --outputPDFFilename="static/zowe-docs-v1.28.x.pdf" --protocolTimeout=1800000 + npx docs-to-pdf --initialDocURLs="https://docs.zowe.org/v1.28.x/whats-new/zowe-announcements,https://docs.zowe.org/v1.28.x/getting-started/overview,https://docs.zowe.org/v1.28.x/user-guide/install-overview,https://docs.zowe.org/v1.28.x/user-guide/zowe-getting-started-tutorial,https://docs.zowe.org/v1.28.x/extend/extend-zowe-overview,https://docs.zowe.org/v1.28.x/troubleshoot/troubleshooting,https://docs.zowe.org/v1.28.x/contribute/roadmap-contribute,https://docs.zowe.org/v1.28.x/appendix/zowe-cli-command-reference" --cssStyle=":root{--ifm-font-size-base: 80%;}" --contentSelector="article" --paginationSelector=".pagination-nav__link--next" --excludeSelectors=".no-pdf,.announcementBar_UUUQ,nav.navbar,.docSidebarContainer_3pwe,.docMainContainer_2pgU .col.col--3,footer.footer,.docItemContainer_2szM > .margin-vert--xl > .row > .col:first-child,.pagination-nav,.docsRating,.navbar__inner,.thin-scrollbar" --coverImage="https://docs.zowe.org/img/zowe-icon.png" --coverTitle="Zowe Version 1.28.x Documentation" --outputPDFFilename="static/zowe-docs-v1.28.x.pdf" --protocolTimeout=1800000 ``` For example, if you're generating the site PDF for a previous minor release, you will need to replace all mentions of `1.28.x` with the correct release version number. If you're updating the v1.28.x PDF to include content for the latest patch release, there is no need to edit the command. diff --git a/static/zowe-docs-v2.12.pdf b/static/zowe-docs-v2.12.x.pdf similarity index 100% rename from static/zowe-docs-v2.12.pdf rename to static/zowe-docs-v2.12.x.pdf diff --git a/static/zowe-docs-v2.14.x.pdf b/static/zowe-docs-v2.14.x.pdf new file mode 100644 index 0000000000..b028a9f3c7 Binary files /dev/null and b/static/zowe-docs-v2.14.x.pdf differ diff --git a/static/zowe-docs-v2.16.x.pdf b/static/zowe-docs-v2.16.x.pdf new file mode 100644 index 0000000000..d3b3513f7f Binary files /dev/null and b/static/zowe-docs-v2.16.x.pdf differ