@sillsdev/docu-notion 0.14.0-alpha.13 → 0.14.0-alpha.14

package/README.md

@@ -90,7 +90,9 @@ One of the big attractions of Notion for large documentation projects is that yo
 
 ## Slugs
 
-By default, pages will be given a slug based on the Notion id. For a human-readable URL, add a notion property named `Slug` to your database pages and enter a value in there that will work well in a URL. That is, no spaces, ?, #, /, etc.
+By default, pages will be given a slug based on the Notion ID. For a human-readable URL, add a notion property named `Slug` to your database pages and enter a value in there that will work well in a URL. That is, no spaces, ?, #, /, etc.
+
+See `Options` to require slugs in Notion.
 
 ## Known Limitations
 
@@ -130,7 +132,8 @@ Options:
 | -l, --log-level <level>               |           | Log level (choices: `info`, `verbose`, `debug`)                                                                                                                                                                    |
 | -i, --img-output-path <string>        |           | Path to directory where images will be stored. If this is not included, images will be placed in the same directory as the document that uses them, which then allows for localization of screenshots.             |
 | -p, --img-prefix-in-markdown <string> |           | When referencing an image from markdown, prefix with this path instead of the full img-output-path. Should be used only in conjunction with --img-output-path.                                                     |
-| -h, --help                            |           | display help for command                                                                                                                                                                                           |
+| --require-slugs                       |           | If set, docu-notion will fail if any pages it would otherwise publish are missing a slug in Notion. |
+| -h, --help                            |           | display help for command                              |
 
 # Plugins
 

package/dist/pull.d.ts

@@ -8,6 +8,7 @@ export type DocuNotionOptions = {
     imgOutputPath: string;
     imgPrefixInMarkdown: string;
     statusTag: string;
+    requireSlugs?: boolean;
 };
 export declare function notionPull(options: DocuNotionOptions): Promise<void>;
 export declare function executeWithRateLimitAndRetries<T>(label: string, asyncFunction: () => Promise<T>): Promise<T>;

package/dist/pull.js

@@ -54,6 +54,7 @@ const counts = {
     skipped_because_empty: 0,
     skipped_because_status: 0,
     skipped_because_level_cannot_have_content: 0,
+    error_because_no_slug: 0,
 };
 function notionPull(options) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -127,10 +128,16 @@ function outputPages(options, config, pages) {
                 ++context.counts.skipped_because_status;
             }
             else {
+                if (options.requireSlugs && !page.hasExplicitSlug) {
+                    (0, log_1.error)(`Page "${page.nameOrTitle}" is missing a required slug. (--require-slugs is set.)`);
+                    ++counts.error_because_no_slug;
+                }
                 const markdown = yield (0, transform_1.getMarkdownForPage)(config, context, page);
                 writePage(page, markdown);
             }
         }
+        if (counts.error_because_no_slug > 0)
+            (0, process_1.exit)(1);
         (0, log_1.info)(`Finished processing ${pages.length} pages`);
         (0, log_1.info)(JSON.stringify(counts));
     });

package/dist/run.js

@@ -61,7 +61,8 @@ function run() {
             "debug",
         ]))
             .option("-i, --img-output-path  <string>", "Path to directory where images will be stored. If this is not included, images will be placed in the same directory as the document that uses them, which then allows for localization of screenshots.")
-            .option("-p, --img-prefix-in-markdown <string>", "When referencing an image from markdown, prefix with this path instead of the full img-output-path. Should be used only in conjunction with --img-output-path.");
+            .option("-p, --img-prefix-in-markdown <string>", "When referencing an image from markdown, prefix with this path instead of the full img-output-path. Should be used only in conjunction with --img-output-path.")
+            .option("--require-slugs", "If set, docu-notion will fail if any pages it would otherwise publish are missing a slug in Notion.", false);
         commander_1.program.showHelpAfterError();
         commander_1.program.parse();
         (0, log_1.setLogLevel)(commander_1.program.opts().logLevel);

package/package.json

@@ -90,5 +90,5 @@
   "volta": {
     "node": "18.16.0"
   },
-  "version": "0.14.0-alpha.13"
+  "version": "0.14.0-alpha.14"
 }