(fix): LaTeX (#4233)

* (docs): document latex * publish docs with latest fern client * upgrade next-mdx-remote and remark-gfm * revert fern.yml workflow * fix replaceReferencedMarkdown * unrevert fern.yml
fern-api · Aug 8, 2024 · 5ee2d80 · 5ee2d80
1 parent d59094f
commit 5ee2d80
Show file tree

Hide file tree

Showing 156 changed files with 1,186 additions and 1,689 deletions.
diff --git a/.github/workflows/fern.yml b/.github/workflows/fern.yml
@@ -14,10 +14,23 @@ jobs:
       - name: Checkout repo
         uses: actions/checkout@v4
 
-      - name: Install Fern
-        run: npm install -g fern-api
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 18
+          cache: "yarn"
+
+      - name: Install
+        run: yarn install
 
       - name: Check API definition is valid
         env:
           FORCE_COLOR: "2"
-        run: fern check
+          FERN_TOKEN: ${{ secrets.FERN_TOKEN }}
+          AUTH0_DOMAIN: ${{ secrets.AUTH0_DOMAIN }}
+          AUTH0_CLIENT_ID: ${{ secrets.AUTH0_CLIENT_ID }}
+          POSTHOG_API_KEY: ${{ secrets.POSTHOG_PROJECT_API_KEY }}
+        run: |
+          yarn workspace @fern-api/cli dist:cli:prod
+          cli_path="$(yarn workspace @fern-api/cli bin fern:prod)"
+          node $cli_path check
+
diff --git a/.github/workflows/preview-docs.yml b/.github/workflows/preview-docs.yml
@@ -23,15 +23,25 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
 
-      - name: Install Fern
-        run: npm install -g fern-api
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 18
+          cache: "yarn"
+
+      - name: Install
+        run: yarn install
 
       - name: Generate preview URL
         id: generate-docs
         env:
           FERN_TOKEN: ${{ secrets.FERN_TOKEN }}
+          AUTH0_DOMAIN: ${{ secrets.AUTH0_DOMAIN }}
+          AUTH0_CLIENT_ID: ${{ secrets.AUTH0_CLIENT_ID }}
+          POSTHOG_API_KEY: ${{ secrets.POSTHOG_PROJECT_API_KEY }}
         run: |
-          OUTPUT=$(fern generate --docs --preview --instance fern.docs.buildwithfern.com/learn 2>&1) || true
+          yarn workspace @fern-api/cli dist:cli:prod
+          cli_path="$(yarn workspace @fern-api/cli bin fern:prod)"
+          OUTPUT=$(node $cli_path generate --docs --preview --instance fern.docs.buildwithfern.com/learn 2>&1) || true
           echo "$OUTPUT"
           URL=$(echo "$OUTPUT" | grep -oP 'Published docs to \K.*(?= \()')
           echo "Preview URL: $URL"

diff --git a/.github/workflows/publish-docs.yml b/.github/workflows/publish-docs.yml
@@ -15,20 +15,31 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
 
-      - name: Install Fern
-        run: npm install -g fern-api
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 18
+          cache: "yarn"
+
+      - name: Install
+        run: yarn install
 
       - name: Publish Docs
         env:
           FERN_TOKEN: ${{ secrets.FERN_TOKEN }}
-        run: fern generate --docs --log-level debug --instance fern.docs.buildwithfern.com/learn
-
-      - name: Install fern-dev CLI
+          AUTH0_DOMAIN: ${{ secrets.AUTH0_DOMAIN }}
+          AUTH0_CLIENT_ID: ${{ secrets.AUTH0_CLIENT_ID }}
+          POSTHOG_API_KEY: ${{ secrets.POSTHOG_PROJECT_API_KEY }}
         run: |
-          npm config set //registry.npmjs.org/:_authToken ${{ secrets.YARN_NPM_AUTH_TOKEN }}
-          npm install -g @fern-api/fern-api-dev --prefix=$HOME/.local
+          yarn workspace @fern-api/cli dist:cli:prod
+          cli_path="$(yarn workspace @fern-api/cli bin fern:prod)"
+          node $cli_path generate --docs --log-level debug --instance fern.docs.buildwithfern.com/learn
+
+      # - name: Install fern-dev CLI
+      #   run: |
+      #     npm config set //registry.npmjs.org/:_authToken ${{ secrets.YARN_NPM_AUTH_TOKEN }}
+      #     npm install -g @fern-api/fern-api-dev --prefix=$HOME/.local
 
-      - name: Publish Docs to dev
-        env:
-          FERN_TOKEN: ${{ secrets.FERN_ORG_TOKEN_DEV }}
-        run: fern-dev generate --docs --log-level debug  --instance fern.docs.dev.buildwithfern.com/learn
+      # - name: Publish Docs to dev
+      #   env:
+      #     FERN_TOKEN: ${{ secrets.FERN_ORG_TOKEN_DEV }}
+      #   run: fern-dev generate --docs --log-level debug  --instance fern.docs.dev.buildwithfern.com/learn