mintlify 2.1.0 → 3.0.4

package/bin/util.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"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"}

package/bin/validation/isValidLink.js

@@ -1,11 +0,0 @@
-export default function isValidLink(href) {
-    // This checks the link is written correctly, not that the page exists.
-    try {
-        new URL(href);
-        return true;
-    }
-    catch (_) {
-        return false;
-    }
-}
-//# sourceMappingURL=isValidLink.js.map

package/bin/validation/isValidLink.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"isValidLink.js","sourceRoot":"","sources":["../../src/validation/isValidLink.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,IAAY;IAC9C,uEAAuE;IACvE,IAAI;QACF,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;KACb;IAAC,OAAO,CAAC,EAAE;QACV,OAAO,KAAK,CAAC;KACd;AACH,CAAC"}

package/bin/validation/stopIfInvalidLink.js

@@ -1,9 +0,0 @@
-import isValidLink from "./isValidLink.js";
-export default function stopIfInvalidLink(href) {
-    if (!isValidLink(href)) {
-        console.log("Invalid link: " + href);
-        console.log("Make sure the link starts with http:// or https://");
-        process.exit(1);
-    }
-}
-//# sourceMappingURL=stopIfInvalidLink.js.map

package/bin/validation/stopIfInvalidLink.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stopIfInvalidLink.js","sourceRoot":"","sources":["../../src/validation/stopIfInvalidLink.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAE3C,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,IAAY;IACpD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE;QACtB,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACjB;AACH,CAAC"}

package/scraper.md

@@ -1,121 +0,0 @@
-# CLI Scraping
-
-The CLI has many commands. This doc focuses on how we coded scraping websites.
-
-## User Interface
-
-There are two main commands:
-
-`mintlify scrape-page [url]`
-
-and
-
-`mintlify scrape-section [url]`
-
-Scraping a page downloads a single page’s content. Scraping a section goes through the navigation and scrapes each page. The code for downloading a page’s content is shared between the two commands.
-
-Important files: `scraping/scrapePageCommands.ts`, `scraping/scrapeSectionAutomatically.ts`
-
-We have `scrape-gitbook-page` and similar commands for debugging. Ignore them, they just call internal functions directly. You should not need to use them unless you are debugging issues with Detecting Frameworks.
-
-## Overwriting
-
-The user has to add a `--overwrite` flag if they want to overwrite their current files.
-
-## Sections vs Websites
-
-We call the command `scrape-section` instead of `scrape-website` because we cannot scrape pages not in the navigation of the URL first passed in. For example, ReadMe has API Reference and other sections accessible through a separate top-navigation which we do not parse. We only scrape the navigation on the left: [https://docs.readme.com/main/docs](https://docs.readme.com/main/docs)
-
-## Detecting Frameworks
-
-The commands look in the page HTML to detect what framework scraper to use. For example, all Docusaurus sites have a metatag with the word Docusaurus in it. Some times, the metatag even has the Docusaurus version.
-
-Each framework’s scrapers live in `scraping/site-scrapers/`
-
-We currently support:
-
-- Docusaurus
-- GitBook
-- ReadMe
-- Intercom
-
-## Terminal Output
-
-We print a line in the terminal for every file we write. `util.ts` has a createPage function that takes care of writing the file and logging.
-
-We use a pencil emoji when we successfully write a file. Images get a picture emoji. Likewise, we print a X emoji when we find a file that already exists and the user has not enabled overwriting files. We use emojis so you can tell what the command is doing without reading each file path.
-
-We also print the file paths when scraping sections so the user can easily copy paste them into mint.json. Note that pages the user already added in Mintlify are not included in the printed example. We do not generate mint.json completely, we are just giving a small example to help users starting from scratch.
-
-```jsx
-Add the following to your navigation in mint.json:
-
-{
-   "group": "Guides",
-   "pages": ["page-we-scraped"]
-}
-```
-
-# Navigation Scraping
-
-Most sites use JavaScript to open navigation menus which do not automatically include the menu buttons in the HTML. We use Puppeteer to click every nested menu so the site adds the menu buttons to the HTML. For example the original site’s HTML:
-
-```jsx
-<div>
-  <a id="my-nested-menu"></a>
-</div>
-```
-
-can turn into this after opening the nested menu:
-
-```jsx
-<div>
-  <a id="my-nested-menu" aria-expanded=true></a>
-  <div>
-     <a href="/page"></a>
-     <a href="/other-page"></a>
-  </div>
-</div>
-```
-
-Ultimately, all section scrapers need to find an array of links to visit then call the scrape page function in a loop.
-
-We use axios instead of Puppeteer if a site doesn’t hide links. Puppeteer is slow.
-
-# Image File Locations
-
-Images go in an `images/` folder because that’s what most users want. Scraping per section uses the same root-level images folder. Scraping per page downloads them to the current location. Thus, scraping a single page from a folder means the user always has to move the images themselves. That’s a trade-off we are comfortable with — trying to detect an existing images folder gets too complicated too fast.
-
-# Cheerio
-
-Cheerio is a library to scrape/handle the HTML after we have it in a string. Most of the work is using inspect-element to view a website and figure out where the content we want is, then writing the corresponding Cheerio code.
-
-# HTML to MDX
-
-We use an open-source library to convert HTML to Markdown: https://github.com/crosstype/node-html-markdown
-
-The `util.ts` createPage function assembles the MDX metadata, we just need to return an object of the form `{ title, description, content }` from each page scraper.
-
-## Parsing Issues
-
-Parsing struggles when documentation websites are using non-standard HTML. For example, code blocks are supposed to use. `<pre><code></code></pre>` but GitBook just uses divs.
-
-We can write custom translators for the library that determine how we parse certain objects.
-
-In some cases, we will want custom translators even if parsing succeeds. For example, ReadMe callouts are using quote syntax
-
-```jsx
-> 💡
-> Callout text
->
-```
-
-When we want to convert them to:
-
-```jsx
-<Tip>Callout text</Tip>
-```
-
-## Regex
-
-You can use regex to make small changes where translators are overkill or there’s no obvious component to modify. For example, here’s the end of `scrapeDocusaurusPage.ts`:

package/src/browser.ts

@@ -1,24 +0,0 @@
-import { launch } from "puppeteer";
-
-export async function startBrowser() {
-  try {
-    return await launch({
-      headless: true,
-      ignoreHTTPSErrors: true,
-    });
-  } catch (err) {
-    console.log("Could not create a browser instance: ", err);
-    process.exit(1);
-  }
-}
-
-export async function getHtmlWithPuppeteer(href: string) {
-  const browser = await startBrowser();
-  const page = await browser.newPage();
-  await page.goto(href, {
-    waitUntil: "networkidle2",
-  });
-  const html = await page.content();
-  browser.close();
-  return html;
-}

package/src/constants.ts

@@ -1,40 +0,0 @@
-import path from "path";
-import * as url from "url";
-import os from "os";
-
-// Change this to bump to a newer version of mint's client
-export const TARGET_MINT_VERSION = "v0.0.9";
-
-// package installation location
-export const INSTALL_PATH = url.fileURLToPath(new URL(".", import.meta.url));
-
-export const HOME_DIR = os.homedir();
-
-export const DOT_MINTLIFY = path.join(HOME_DIR, ".mintlify");
-
-export const VERSION_PATH = path.join(DOT_MINTLIFY, "mint", "mint-version.txt");
-
-export const CLIENT_PATH = path.join(DOT_MINTLIFY, "mint", "client");
-
-export const MINT_PATH = path.join(DOT_MINTLIFY, "mint");
-
-// command execution location
-export const CMD_EXEC_PATH = process.cwd();
-
-export const SUPPORTED_MEDIA_EXTENSIONS = [
-  "jpeg",
-  "jpg",
-  "jfif",
-  "pjpeg",
-  "pjp",
-  "png",
-  "svg",
-  "svgz",
-  "ico",
-  "webp",
-  "gif",
-  "apng",
-  "avif",
-  "bmp",
-  "mp4",
-];

package/src/downloadImage.ts

@@ -1,110 +0,0 @@
-import { existsSync, mkdirSync, createWriteStream } from "fs";
-import path from "path";
-import axios from "axios";
-import { getFileExtension } from "./util.js";
-import { SUPPORTED_MEDIA_EXTENSIONS } from "./constants.js";
-
-async function writeImageToFile(
-  imageSrc: string,
-  writePath: string,
-  overwrite: boolean
-) {
-  // Avoid unnecessary downloads
-  if (existsSync(writePath) && !overwrite) {
-    return Promise.reject({
-      code: "EEXIST",
-    });
-  }
-
-  // Create the folders needed if they're missing
-  mkdirSync(path.dirname(writePath), { recursive: true });
-
-  const writer = createWriteStream(writePath);
-
-  try {
-    const response = await axios.get(imageSrc, {
-      responseType: "stream",
-    });
-    // wx prevents overwriting an image with the exact same name
-    // being created in the time we were downloading
-    response.data.pipe(writer, {
-      flag: "wx",
-    });
-
-    return new Promise((resolve, reject) => {
-      writer.on("finish", resolve);
-      writer.on("error", reject);
-    });
-  } catch (e) {
-    return Promise.reject({
-      code: "ENOTFOUND",
-    });
-  }
-}
-
-export function isValidImageSrc(
-  src: string,
-  skipValidateImageExtension?: boolean
-) {
-  if (!src) {
-    return false;
-  }
-
-  // We do not support downloading base64 in-line images.
-  if (src.startsWith("data:")) {
-    return false;
-  }
-
-  if (skipValidateImageExtension) {
-    return true;
-  }
-
-  const imageHref = removeMetadataFromImageSrc(src);
-  const ext = getFileExtension(imageHref);
-
-  if (!SUPPORTED_MEDIA_EXTENSIONS.includes(ext)) {
-    console.error("🚨 We do not support the file extension: " + ext);
-    return false;
-  }
-
-  return true;
-}
-
-export function removeMetadataFromImageSrc(src: string) {
-  // Part of the URL standard
-  const metadataSymbols = ["?", "#"];
-
-  metadataSymbols.forEach((dividerSymbol) => {
-    // Some frameworks add metadata after the file extension, we need to remove that.
-    src = src.split(dividerSymbol)[0];
-  });
-
-  return src;
-}
-
-export function cleanImageSrc(src: string, origin: string) {
-  // Add origin if the image tags are using relative sources
-  return src.startsWith("http") ? src : new URL(src, origin).href;
-}
-
-export default async function downloadImage(
-  imageSrc: string,
-  writePath: string,
-  overwrite: boolean = false
-) {
-  await writeImageToFile(imageSrc, writePath, overwrite)
-    .then(() => {
-      console.log("🖼️ - " + writePath);
-    })
-    .catch((e) => {
-      if (e.code === "EEXIST") {
-        console.log(`❌ Skipping existing image ${writePath}`);
-      } else if (e.code === "ENOTFOUND") {
-        console.error(
-          `🚨 Cannot download the image, address not found ${imageSrc}`
-        );
-      } else {
-        console.error(e);
-      }
-    });
-}

package/src/index.ts

@@ -1,112 +0,0 @@
-#!/usr/bin/env node
-
-import yargs from "yargs";
-import { hideBin } from "yargs/helpers";
-import {
-  scrapePageAutomatically,
-  scrapePageWrapper,
-} from "./scraping/scrapePageCommands.js";
-import { scrapeGitBookPage } from "./scraping/site-scrapers/scrapeGitBookPage.js";
-import { scrapeReadMePage } from "./scraping/site-scrapers/scrapeReadMePage.js";
-import {
-  scrapeSectionAutomatically,
-  scrapeSectionAxiosWrapper,
-  scrapeGitbookSectionCommand,
-} from "./scraping/scrapeSectionCommands.js";
-import { scrapeReadMeSection } from "./scraping/site-scrapers/scrapeReadMeSection.js";
-import dev from "./local-preview/index.js";
-import installDepsCommand from "./local-preview/helper-commands/installDepsCommand.js";
-import { scrapeIntercomPage } from "./scraping/site-scrapers/Intercom/scrapeIntercomPage.js";
-import { scrapeIntercomSection } from "./scraping/site-scrapers/Intercom/scrapeIntercomSection.js";
-
-yargs(hideBin(process.argv))
-  .command(
-    "dev",
-    "Runs Mintlify locally (Must run in directory with mint.json)",
-    () => {},
-    async (argv) => {
-      await dev(argv);
-    }
-  )
-  .command(
-    "install",
-    "Install dependencies for local Mintlify",
-    () => {},
-    installDepsCommand
-  )
-  .command(
-    "scrape-page [url]",
-    "Scrapes a page",
-    () => {},
-    async (argv) => {
-      await scrapePageAutomatically(argv);
-    }
-  )
-  .command(
-    "scrape-gitbook-page [url]",
-    "Scrapes a GitBook page",
-    () => {},
-    async (argv) => {
-      await scrapePageWrapper(argv, scrapeGitBookPage);
-    }
-  )
-  .command(
-    "scrape-readme-page [url]",
-    "Scrapes a ReadMe page",
-    () => {},
-    async (argv) => {
-      await scrapePageWrapper(argv, scrapeReadMePage);
-    }
-  )
-  .command(
-    "scrape-intercom-page [url]",
-    "Scrapes a Intercom page",
-    () => {},
-    async (argv) => {
-      await scrapePageWrapper(argv, scrapeIntercomPage);
-    }
-  )
-  .command(
-    "scrape-section [url]",
-    "Scrapes the docs in the section",
-    () => {},
-    async (argv) => {
-      await scrapeSectionAutomatically(argv);
-    }
-  )
-  .command(
-    "scrape-gitbook-section [url]",
-    "Scrapes the Gitbook section",
-    () => {},
-    async (argv) => {
-      await scrapeGitbookSectionCommand(argv);
-    }
-  )
-  .command(
-    "scrape-readme-section [url]",
-    "Scrapes the ReadMe section",
-    () => {},
-    async (argv) => {
-      await scrapeSectionAxiosWrapper(argv, scrapeReadMeSection);
-    }
-  )
-  .command(
-    "scrape-intercom-section [url]",
-    "Scrapes the Intercom section",
-    () => {},
-    async (argv) => {
-      await scrapeSectionAxiosWrapper(argv, scrapeIntercomSection);
-    }
-  )
-  // Print the help menu when the user enters an invalid command.
-  .strictCommands()
-  .demandCommand(
-    1,
-    "Unknown command. See above for the list of supported commands."
-  )
-
-  // Alias option flags --help = -h, --version = -v
-  .alias("h", "help")
-  .alias("v", "version")
-
-  .parse();

package/src/local-preview/helper-commands/installDepsCommand.ts

@@ -1,13 +0,0 @@
-import shell from "shelljs";
-import { CLIENT_PATH } from "../../constants.js";
-import { buildLogger, ensureYarn } from "../../util.js";
-
-const installDeps = async () => {
-  const logger = buildLogger("");
-  ensureYarn(logger);
-  shell.cd(CLIENT_PATH);
-  shell.exec("yarn");
-  logger.succeed("Dependencies installed.");
-};
-
-export default installDeps;

package/src/local-preview/index.ts

@@ -1,195 +0,0 @@
-import Chalk from "chalk";
-import child_process from "child_process";
-import open from "open";
-import fse, { pathExists } from "fs-extra";
-import inquirer from "inquirer";
-import { isInternetAvailable } from "is-internet-available";
-import path from "path";
-import shell from "shelljs";
-import { Octokit } from "@octokit/rest";
-import {
-  CLIENT_PATH,
-  HOME_DIR,
-  DOT_MINTLIFY,
-  CMD_EXEC_PATH,
-  TARGET_MINT_VERSION,
-  VERSION_PATH,
-  MINT_PATH,
-} from "../constants.js";
-import { buildLogger, ensureYarn } from "../util.js";
-import listener from "./listener/index.js";
-import { ArgumentsCamelCase } from "yargs";
-import { getConfigPath } from "./listener/utils/mintConfigFile.js";
-
-const nodeModulesExists = async () => {
-  return pathExists(path.join(DOT_MINTLIFY, "mint", "client", "node_modules"));
-};
-
-const promptForYarn = async () => {
-  const yarnInstalled = shell.which("yarn");
-  if (!yarnInstalled) {
-    await inquirer
-      .prompt([
-        {
-          type: "confirm",
-          name: "confirm",
-          message: "yarn must be globally installed. Install yarn?",
-          default: true,
-        },
-      ])
-      .then(({ confirm }) => {
-        if (confirm) {
-          shell.exec("npm install --global yarn");
-        } else {
-          console.log("Installation cancelled.");
-        }
-      });
-  }
-};
-
-const downloadTargetMint = async (logger) => {
-  fse.emptyDirSync(MINT_PATH);
-
-  logger.text = "Downloading Mintlify framework...";
-
-  const octokit = new Octokit();
-  const downloadRes = await octokit.repos.downloadTarballArchive({
-    owner: "mintlify",
-    repo: "mint",
-    ref: TARGET_MINT_VERSION,
-  });
-
-  logger.text = "Extracting Mintlify framework...";
-  const TAR_PATH = path.join(MINT_PATH, "mint.tar.gz");
-  fse.writeFileSync(TAR_PATH, Buffer.from(downloadRes.data as any));
-
-  // strip-components 1 removes the top level directory from the unzipped content
-  // which is a folder with the release sha
-  fse.mkdirSync(path.join(MINT_PATH, "mint-tmp"));
-  shell.exec("tar -xzf mint.tar.gz -C mint-tmp --strip-components 1", {
-    silent: true,
-  });
-
-  fse.removeSync(TAR_PATH);
-
-  fse.moveSync(
-    path.join(MINT_PATH, "mint-tmp", "client"),
-    path.join(CLIENT_PATH)
-  );
-
-  fse.writeFileSync(VERSION_PATH, TARGET_MINT_VERSION);
-
-  // Delete unnecessary content downloaded from GitHub
-  fse.removeSync(path.join(MINT_PATH, "mint-tmp"));
-
-  logger.text = "Installing dependencies...";
-
-  ensureYarn(logger);
-  shell.cd(CLIENT_PATH);
-  shell.exec("yarn", { silent: true });
-};
-
-const checkForMintJson = async (logger) => {
-  const configPath = await getConfigPath(CMD_EXEC_PATH);
-  if (configPath == null) {
-    logger.fail("Must be ran in a directory where a mint.json file exists.");
-    process.exit(1);
-  }
-  return;
-};
-
-const dev = async (argv: ArgumentsCamelCase) => {
-  shell.cd(HOME_DIR);
-  await promptForYarn();
-  const logger = buildLogger("Preparing local Mintlify instance...");
-  await fse.ensureDir(MINT_PATH);
-  shell.cd(MINT_PATH);
-
-  const internet = await isInternetAvailable();
-  if (!internet && !(await pathExists(CLIENT_PATH))) {
-    logger.fail(
-      "Running mintlify dev for the first time requires an internet connection."
-    );
-    process.exit(1);
-  }
-
-  if (internet) {
-    const mintVersionExists = await pathExists(VERSION_PATH);
-
-    let needToDownloadTargetMint = !mintVersionExists;
-
-    if (mintVersionExists) {
-      const currVersion = fse.readFileSync(VERSION_PATH, "utf8");
-      if (currVersion !== TARGET_MINT_VERSION) {
-        needToDownloadTargetMint = true;
-      }
-    }
-
-    if (needToDownloadTargetMint) {
-      await downloadTargetMint(logger);
-    }
-  }
-
-  if (!(await nodeModulesExists())) {
-    if (!internet) {
-      logger.fail(`Dependencies are missing and you are offline. Connect to the internet and run
-  
-      mintlify install
-      
-      `);
-    } else {
-      logger.fail(`Dependencies were not installed correctly, run
-  
-      mintlify install
-      
-      `);
-    }
-    process.exit(1);
-  }
-  await checkForMintJson(logger);
-  shell.cd(CLIENT_PATH);
-  const relativePath = path.relative(CLIENT_PATH, CMD_EXEC_PATH);
-  child_process.spawnSync("yarn preconfigure", [relativePath], { shell: true });
-  logger.succeed("Local Mintlify instance is ready. Launching your site...");
-  run((argv.port as string) || "3000");
-};
-
-const run = (port: string) => {
-  shell.cd(CLIENT_PATH);
-
-  // next-remote-watch can only receive ports as env variables
-  // https://github.com/hashicorp/next-remote-watch/issues/23
-  const mintlifyDevProcess = child_process.spawn("npm run dev-watch", {
-    env: {
-      ...process.env,
-      PORT: port,
-    },
-    cwd: CLIENT_PATH,
-    stdio: "pipe",
-    shell: true,
-  });
-  mintlifyDevProcess.stdout.on("data", (data) => {
-    const output = data.toString();
-    console.log(output);
-    if (output.startsWith("> Ready on http://localhost:")) {
-      console.log(
-        `🌿 ${Chalk.green(
-          `Your local preview is available at http://localhost:${port}`
-        )}`
-      );
-      console.log(
-        `🌿 ${Chalk.green("Press Ctrl+C any time to stop the local preview.")}`
-      );
-      open(`http://localhost:${port}`);
-    }
-  });
-  const onExit = () => {
-    mintlifyDevProcess.kill("SIGINT");
-    process.exit(0);
-  };
-  process.on("SIGINT", onExit);
-  process.on("SIGTERM", onExit);
-  listener();
-};
-
-export default dev;