fix: Name Change

Author: hatton

README.md

@@ -1,23 +1,23 @@
-# notion-pull-mdx
+# docu-notion
 
-notion-pull-mdx lets you use Notion as your editor for markdown-based static site generators like [Docusaurus](https://docusaurus.io/). Using Notion instead of raw markdown files means that you don't have to teach non-developers how to make git commits and pull requests. It also allows you to leverage Notion's database tools to control workflow, Notion's commenting feature to discuss changes, etc.
+docu-notion lets you use Notion as your editor for [Docusaurus](https://docusaurus.io/). Using Notion instead of raw markdown files means that you don't have to teach non-developers how to make git commits and pull requests. It also allows you to leverage Notion's database tools to control workflow, Notion's commenting feature to discuss changes, etc.
 
-Example Site: https://sillsdev.github.io/notion-pull-mdx-sample-site/
+Example Site: https://sillsdev.github.io/docu-notion-sample-site/
 
 # Instructions
 
 ## 1. Set up your documentation site.
 
-First, prepare your markdown-based static file system like [Docusaurus](https://docusaurus.io/). For a shortcut with github actions, search, and deployment to github pages, you can just copy [this template](https://github.com/sillsdev/notion-pull-mdx-sample-site).
+First, prepare your markdown-based static file system like [Docusaurus](https://docusaurus.io/). For a shortcut with github actions, search, and deployment to github pages, you can just copy [this template](https://github.com/sillsdev/docu-notion-sample-site).
 
-## 2. In Notion, duplicate the notion-pull-mdx template
+## 2. In Notion, duplicate the docu-notion template
 
 Go to [this template page](https://hattonjohn.notion.site/Documentation-Template-Docusaurus-0e998b32da3c47edad0f62a25b49818c). Duplicate it into your own workspace.
 You can name it anything you like, e.g. "Documentation Root".
 
 ## 3. Create a Notion Integration
 
-In order for notion-pull-mdx to read your site via Notion's API, you need to create what Notion calls an "integration". Follow [these instructions](https://developers.notion.com/docs/getting-started) to make an integration and get your token. Limit your integration to "READ" access.
+In order for docu-notion to read your site via Notion's API, you need to create what Notion calls an "integration". Follow [these instructions](https://developers.notion.com/docs/getting-started) to make an integration and get your token. Limit your integration to "READ" access.
 
 ## 4. "Invite" your Notion Integration to read you page
 
@@ -27,7 +27,7 @@ In Notion, click "Share" on the root of your documentation and "invite" your int
 
 ## 5. Add your pages under your Outline page.
 
-Currently, notion-pull-mdx expects that each page has only one of the following: subpages, links to other pages, or normal content. Do not mix them. You can add content pages directly here, but then you won't be able to make use of the workflow features. If those matter to you, instead make new pages under the "Database" and then link to them in your outline pages.
+Currently, docu-notion expects that each page has only one of the following: subpages, links to other pages, or normal content. Do not mix them. You can add content pages directly here, but then you won't be able to make use of the workflow features. If those matter to you, instead make new pages under the "Database" and then link to them in your outline pages.
 
 ## 6. Pull your pages
 
@@ -38,34 +38,34 @@ means that the id is "0456aa5842946PRETEND4f37c97a0e5".
 Determine where you want the markdown files and images to land. The following works well for Docusaurus instances:
 
 ```
-npx notion-pull-mdx -n secret_PRETEND123456789PRETEND123456789PRETEND6789 -r 0456aa5842946PRETEND4f37c97a0e5"
+npx docu-notion -n secret_PRETEND123456789PRETEND123456789PRETEND6789 -r 0456aa5842946PRETEND4f37c97a0e5"
 ```
 
 Likely, you will want to store these codes in your environment variables and then use them like this:
 
 ```
 (windows)
-npx notion-pull-mdx -n %MY_NOTION_TOKEN% -r %MY_NOTION_DOCS_ROOT_PAGE_ID%
+npx docu-notion -n %MY_NOTION_TOKEN% -r %MY_NOTION_DOCS_ROOT_PAGE_ID%
 ```
 
 ```
 (linux / mac)
-npx notion-pull-mdx -n $MY_NOTION_TOKEN -r $MY_NOTION_DOCS_ROOT_PAGE_ID
+npx docu-notion -n $MY_NOTION_TOKEN -r $MY_NOTION_DOCS_ROOT_PAGE_ID
 ```
 
-NOTE: In the above, we are using `npx` to use the latest `notion-pull-mdx`. A more conservative approach would be to `npm i cross-var notion-pull-mdx` and then create a script in your package.json like this:
+NOTE: In the above, we are using `npx` to use the latest `docu-notion`. A more conservative approach would be to `npm i cross-var docu-notion` and then create a script in your package.json like this:
 
 ```
  "scripts": {
-     "pull": "cross-var notion-pull-mdx -n %NOTION_PULL_INTEGRATION_TOKEN% -r %NOTION_PULL_ROOT_PAGE%"
+     "pull": "cross-var docu-notion -n %NOTION_PULL_INTEGRATION_TOKEN% -r %NOTION_PULL_ROOT_PAGE%"
   }
 ```
 
 and then run that with `npm run pull`.
 
 ## 7. Commit
 
-Most projects should probably commit the current markdown and image files each time you run notion-pull-mdx.
+Most projects should probably commit the current markdown and image files each time you run docu-notion.
 
 Note that if you choose not to commit, the workflow feature (see below) won't work for you. Imagine the case where a document that previously had a `Status` property of `Publish` now has a different status. You probably want to keep publishing the old version until the new one is ready. But if you don't commit files, your CI system (e.g. Github Actions) won't have the old version around, so it will disappear from your site.
 
@@ -75,27 +75,27 @@ One of the big attractions of Notion for large documentation projects is that yo
 
 ![image](https://user-images.githubusercontent.com/8448/168929745-e6529375-bb1e-47e9-b8a6-7a1467c8900f.png)
 
-`notion-pull-mdx` supports this by letting you link to database pages from your outline.
+`docu-notion` supports this by letting you link to database pages from your outline.
 
 ![image](https://user-images.githubusercontent.com/8448/168929668-f83d7c86-75d2-48e9-940c-84c5268a2854.png)
 
 ## Known Limitations
 
-notion-pull-mdx is not doing anything smart with regards to previously Published but now not Published documents. All it does is ignore every Notion document that doesn't have `status == Publish`. So if the old version of the document is still in your file tree when your static site generator (e.g. Docusaurus) runs, then it will appear on your website. If it isn't there, it won't. If you rename directories or move the document, notion-pull-mdx will not realize this and will delete the previously published markdown file.
+docu-notion is not doing anything smart with regards to previously Published but now not Published documents. All it does is ignore every Notion document that doesn't have `status == Publish`. So if the old version of the document is still in your file tree when your static site generator (e.g. Docusaurus) runs, then it will appear on your website. If it isn't there, it won't. If you rename directories or move the document, docu-notion will not realize this and will delete the previously published markdown file.
 
 Links from one document to another in Notion are not yet converted to local links.
 
-notion-pull-mdx makes some attempt to keep the right order of things, but there are definitely cases where it isn't smart enough yet.
+docu-notion makes some attempt to keep the right order of things, but there are definitely cases where it isn't smart enough yet.
 
 # Text Localization
 
 Localize your files in Crowdin (or whatever) based on the markdown files, not in Notion. For how to do this with Docusaurus, see [Docusaurus i18n](https://docusaurus.io/docs/i18n/crowdin).
 
 # Screenshot Localization
 
-The only way we know of to provide localization of image in the current Docusaurus (2.0) is to place the images in the same directory as the markdown, and use relative paths for images. Most projects probably won't localize _every_ image, so we also need a way to "fall back" to the original screenshot when the localized one is missing. `notion-pull-mdx` facilitates this. If no localized version of an image is available, `notion-pull-mdx` places a copy of the original image into the correct location.
+The only way we know of to provide localization of image in the current Docusaurus (2.0) is to place the images in the same directory as the markdown, and use relative paths for images. Most projects probably won't localize _every_ image, so we also need a way to "fall back" to the original screenshot when the localized one is missing. `docu-notion` facilitates this. If no localized version of an image is available, `docu-notion` places a copy of the original image into the correct location.
 
-So how do you provide these localized screenshot files? Crowdin can handle localizing assets, and in the future we may support that. For now, we currently support a different approach. If you place for example `fr https:\\imgur.com\1234.png` in the caption of a screenshot in Notion, `notion-pull-mdx` will fetch that image and save it in the right place to be found when in French mode. Getting URLs to screenshots is easy with screenshot utilities such as [Greenshot](https://getgreenshot.org/) that support uploading to imgur. Note that `notion-pull-mdx` stores a copy of all images in your source tree, so you wouldn't lose the images if imgur were to go away.
+So how do you provide these localized screenshot files? Crowdin can handle localizing assets, and in the future we may support that. For now, we currently support a different approach. If you place for example `fr https:\\imgur.com\1234.png` in the caption of a screenshot in Notion, `docu-notion` will fetch that image and save it in the right place to be found when in French mode. Getting URLs to screenshots is easy with screenshot utilities such as [Greenshot](https://getgreenshot.org/) that support uploading to imgur. Note that `docu-notion` stores a copy of all images in your source tree, so you wouldn't lose the images if imgur were to go away.
 
 NOTE: that as far as I can tell, when you run `docusaurus start` docusaurus 2.0 offers the language picker but it doesn't actually work. So to test out the localized version, do `docusaurus build` followed by `docusaurus serve`.
 

package.json

@@ -1,6 +1,5 @@
 {
-  "name": "notion-pull-mdx",
-  "version": "0.0.0-development",
+  "name": "docu-notion",
   "description": "Download Notion pages as markdown and image files, preserving hierarchy and enabling workflow properties. Works with Docusaurus.",
   "main": "./dist/index.js",
   "bin": "dist/index.js",
@@ -15,12 +14,13 @@
     "notion-download": "node dist/index.js",
     "cmdhelp": "ts-node --compiler-options \"{\\\"module\\\": \\\"commonjs\\\"}\" src/index.ts",
     "// test out with my sample notion db": "",
+    "t": "cross-var ts-node --compiler-options \"{\\\"module\\\": \\\"commonjs\\\"}\" src/index.ts -n %NOTION_PULL_INTEGRATION_TOKEN% -r %NOTION_PULL_ROOT_PAGE%",
     "sample": "cross-var ts-node --compiler-options \"{\\\"module\\\": \\\"commonjs\\\"}\" src/index.ts -n %NOTION_PULL_INTEGRATION_TOKEN% -r %NOTION_PULL_ROOT_PAGE% -m ./sample --locales en,es,fr,de --log-level verbose",
     "sample-with-paths": "cross-var ts-node --compiler-options \"{\\\"module\\\": \\\"commonjs\\\"}\" src/index.ts -n %NOTION_PULL_INTEGRATION_TOKEN% -r %NOTION_PULL_ROOT_PAGE% -m ./sample --img-output-path ./sample_img"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/sillsdev/notion-pull-mdx.git"
+    "url": "git+https://github.com/sillsdev/docu-notion.git"
   },
   "license": "MIT",
   "author": {
@@ -37,9 +37,9 @@
     "markdown"
   ],
   "bugs": {
-    "url": "https://github.com/sillsdev/notion-pull-mdx/issues"
+    "url": "https://github.com/sillsdev/docu-notion/issues"
   },
-  "homepage": "https://github.com/sillsdev/notion-pull-mdx#readme",
+  "homepage": "https://github.com/sillsdev/docu-notion#readme",
   "//file-type": "have to use this version before they switched to ESM, which gives a compile error related to require()",
   "//node-fetch@2.6.6file-type": "have to use this version before they switched to ESM, which gives a compile error related to require()",
   "//chalk@4": "also ESM related problem",

src/DocusaurusTweaks.ts

@@ -69,7 +69,7 @@ function notionEmbedsToMDX(input: string): {
       regex: /\[.*\]\((http.*(\.(gif|GIF)))\)/gm,
       ...gif,
     },
-    // This is included in notion-pull-mdx just because we built notion-pull-mdx for our own doc site, and it needs this.
+    // This is included in docu-notion just because we built docu-notion for our own doc site, and it needs this.
     // bloomPUB: {
     //   regex: /\[.*\]\((.*bloomlibrary\.org.*.*book.*)\)/gm,
     //   // enhance: it would be nice if we could fill in the `host` parameter for analytics

src/NotionImage.ts

@@ -68,8 +68,6 @@ async function readPrimaryImage(imageSet: ImageSet) {
 async function saveImage(imageSet: ImageSet): Promise<void> {
   writeImageIfNew(imageSet.primaryFileOutputPath!, imageSet.primaryBuffer!);
 
-  let foundLocalizedImage = false;
-
   for (const localizedImage of imageSet.localizedUrls) {
     let buffer = imageSet.primaryBuffer!;
     // if we have a urls for the localized screenshot, download it
@@ -87,9 +85,7 @@ async function saveImage(imageSet: ImageSet): Promise<void> {
     const directory = `./i18n/${
       localizedImage.iso632Code
     }/docusaurus-plugin-content-docs/current/${imageSet.relativePathToParentDocument!}`;
-    if (!foundLocalizedImage) {
-      foundLocalizedImage = true;
-    }
+
     writeImageIfNew(directory + "/" + imageSet.outputFileName!, buffer);
   }
 }

src/NotionPage.ts

@@ -16,7 +16,7 @@ const notionLimiter = new RateLimiter({
 let notionClient: Client;
 
 // Notion has 2 kinds of pages: a normal one which is just content, and what I'm calling a "database page", which has whatever properties you put on it.
-// notion-pull-mdx supports the later via links from outline pages. That is, you put the database pages in a database, then separately, in the outline, you
+// docu-notion supports the later via links from outline pages. That is, you put the database pages in a database, then separately, in the outline, you
 // create pages for each node of the outline and then add links from those to the database pages. In this way, we get the benefits of database
 // pages (metadata, workflow, etc) and also normal pages (order, position in the outline).
 export enum PageType {

src/css/notion-styles.css

@@ -23,7 +23,7 @@
 .notion-row {
   display: grid;
   grid-auto-flow: column;
-  /* at the moment, notion-pull-mdx doesn't give us column widths or ratios. So we
+  /* at the moment, docu-notion doesn't give us column widths or ratios. So we
   could let css layout decide the widths. Instead at the moment we're saying
   let's just have each column be equal. This is easier for the author using
   Notion to remember than having to guess at what the layout will be. */

src/index.ts

@@ -6,9 +6,9 @@ import { setLogLevel } from "./log";
 import { notionPull, Options } from "./pull";
 const pkg = require("../package.json");
 // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
-console.log(`notion-pull-mdx version ${pkg.version}`);
+console.log(`docu-notion version ${pkg.version}`);
 
-program.name("notion-pull-mdx").description("");
+program.name("docu-notion").description("");
 program
   .requiredOption("-n, --notion-token <string>", "notion api token")
   .requiredOption(
@@ -57,7 +57,7 @@ setLogLevel(program.opts().logLevel);
 
 // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion
 void notionPull(program.opts() as Options).then(() =>
-  console.log("notion-pull-mdx Finished.")
+  console.log("docu-notion Finished.")
 );
 
 function parseLocales(value: string): string[] {

src/pull.ts

@@ -38,7 +38,7 @@ const pages = new Array<NotionPage>();
 export async function notionPull(incomingOptions: Options): Promise<void> {
   options = incomingOptions;
 
-  // It's helpful when troubleshooting CI secrets and environment variables to see what options actually made it to notion-pull-mdx.
+  // It's helpful when troubleshooting CI secrets and environment variables to see what options actually made it to docu-notion.
   // eslint-disable-next-line @typescript-eslint/no-unsafe-call
   const optionsForLogging = { ...incomingOptions };
   // Just show the first few letters of the notion token, which start with "secret" anyhow.
@@ -110,7 +110,7 @@ async function getPagesRecursively(
 
   if (!rootLevel && pageInfo.hasParagraphs && pageInfo.childPages.length) {
     error(
-      `Skipping "${pageInTheOutline.nameOrTitle}"  and its children. notion-pull-mdx does not support pages that are both levels and have content at the same time.`
+      `Skipping "${pageInTheOutline.nameOrTitle}"  and its children. docu-notion does not support pages that are both levels and have content at the same time.`
     );
 
     return;