Add markdown to confluence

markdown-to-confluence/.gitignore

@@ -0,0 +1,3 @@
+node_modules
+.env
+docs

markdown-to-confluence/Dockerfile

@@ -0,0 +1,15 @@
+FROM node:19-alpine3.17
+
+WORKDIR /
+
+RUN apk add --no-cache jq bash git
+
+COPY . .
+
+RUN npm install
+
+RUN chmod +x /entrypoint.sh
+RUN mkdir -p /.cache/md
+RUN chmod 777 /.cache/md
+
+ENTRYPOINT ["/entrypoint.sh"]

markdown-to-confluence/README.md

@@ -0,0 +1,23 @@
+# Markdown to Confluence
+
+This actions converts markdown to confluence markup and uploads it.
+
+## Configuration
+```yaml
+  base_folder:
+    description: "location of documentation"
+    required: false
+    default: "./"
+  confluence_url:
+    description: "Base URL to Atlassian with network name"
+    required: true
+  confluence_space_key:
+    description: "The space key found in the URL on Confluence"
+    required: true
+  auth_username:
+    description: "The username of the user pushing changes to Confluence"
+    required: true
+  auth_api_token:
+    description: "The authentication token from the user pushing changes to Confluence"
+    required: true
+```

markdown-to-confluence/action.yaml

@@ -0,0 +1,25 @@
+name: "Markdown To Confluence"
+description: "Converts the contents of documentation folder to HTML and uploads to Confluence"
+inputs:
+  base_folder:
+    description: "location of documentation"
+    required: false
+    default: "./"
+  confluence_url:
+    description: "Base URL to Atlassian with network name"
+    required: true
+  confluence_space_key:
+    description: "The space key found in the URL on Confluence"
+    required: true
+  auth_username:
+    description: "The username of the user pushing changes to Confluence"
+    required: true
+  auth_api_token:
+    description: "The authentication token from the user pushing changes to Confluence"
+    required: true
+outputs:
+  status:
+    description: "Status of the converter"
+runs:
+  using: "docker"
+  image: "Dockerfile"

markdown-to-confluence/entrypoint.sh

@@ -0,0 +1,2 @@
+#!/bin/bash
+node /main.js

markdown-to-confluence/main.js

@@ -0,0 +1,253 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import axios from 'axios';
+import { ConfluenceClient } from 'confluence.js';
+import dotenv from 'dotenv';
+import FastGlob from 'fast-glob';
+import { toHtml } from 'hast-util-to-html';
+import { fromMarkdown } from 'mdast-util-from-markdown';
+import { gfmFromMarkdown } from 'mdast-util-gfm';
+import { mathFromMarkdown } from 'mdast-util-math';
+import { toHast } from 'mdast-util-to-hast';
+import { gfm } from 'micromark-extension-gfm';
+import { math } from 'micromark-extension-math';
+import { initialize, svg2png } from 'svg2png-wasm';
+import texsvg from 'texsvg';
+import { getInput } from '@actions/core';
+
+await initialize(
+  await readFile('./node_modules/svg2png-wasm/svg2png_wasm_bg.wasm'),
+);
+
+dotenv.config()
+const tempdir = process.env.NODE_ENV === 'dev' ? os.tmpdir() : '';
+
+if (tempdir) {
+  await mkdir(tempdir + '/.cache/md', {recursive: true});
+}
+
+var config = {
+  username: getInput('auth_username') || process.env.auth_username,
+  password: getInput('auth_api_token') || process.env.auth_api_token,
+  baseUrl: getInput('confluence_url') || process.env.confluence_url,
+  space: getInput('confluence_space_key') || process.env.confluence_space_key,
+  baseFolder: getInput('base_folder') ? path.join('/github/workspace', getInput('base_folder')) : process.env.base_folder
+};
+var confluence = new ConfluenceClient({
+  host: config.baseUrl,
+  newErrorHandling: true,
+  authentication: {
+    basic: {
+      email: config.username,
+      apiToken: config.password
+    }
+  }
+});
+const files = await FastGlob( '**/*.md', {
+  cwd: config.baseFolder
+})
+let configFile = {}
+try {
+  configFile = JSON.parse(await readFile(path.join(config.baseFolder, 'settings.json')))
+} catch (e) {
+  console.log('No config file found')
+}
+
+const asyncMap = async (array, fn) => {
+  const results = []
+  for (const item of array) {
+    results.push(await fn(item))
+  }
+  return results
+}
+
+const toBuffer = (arrayBuffer) => {
+  const buffer = Buffer.alloc(arrayBuffer.byteLength);
+  const view = new Uint8Array(arrayBuffer);
+  for (let i = 0; i < buffer.length; ++i) {
+    buffer[i] = view[i];
+  }
+  return buffer;
+}
+for (const file of files) {
+  const markdown = await readFile(path.join(config.baseFolder, file), {
+    encoding: 'utf-8'
+  })
+  const mdast = fromMarkdown(markdown, {
+    extensions: [gfm(), math()],
+    mdastExtensions: [gfmFromMarkdown(), mathFromMarkdown()],
+  })
+
+
+  const worker = (file, assets) => async (node) => {
+    if (node.children) {
+      node.children = await asyncMap(node.children, worker(file, assets))
+    }
+    if (node.type === 'image') {
+      assets.push(node.url)
+      return {
+        type: 'image',
+        url: node.url,
+      }
+    }
+    if (node.type === 'code' && node.lang === 'mermaid') {
+      const image = 'img-' + assets.length + '.png'
+      const response = await axios.request({
+        url: 'https://mermaid.ink/img/' + encodeURIComponent(Buffer.from(node.value).toString('base64')),
+        method: 'GET',
+        responseType: 'arraybuffer'
+      })
+      const buffer = await response.data
+      await writeFile(path.join(tempdir + '/.cache/md', image), toBuffer(buffer))
+      assets.push(image)
+      return {
+        type: 'image',
+        url: image,
+      }
+    }
+    if (node.type === 'math' || node.type === 'inlineMath') {
+      const svg = await texsvg(node.value);
+      const image = 'img-' + assets.length + '.png'
+      const png = await svg2png(svg, {
+        scale:  node.type === 'inlineMath' ? 1 : 2,
+        backgroundColor: '#fff'
+      })
+      await writeFile(path.join( tempdir + '/.cache/md', image), png)
+      assets.push(image)
+      return {
+        type: 'image',
+        url: image
+      }
+    }
+    return node
+  }
+
+  const assets = []
+
+  mdast.children = await asyncMap(mdast.children, worker(file, assets))
+  const hast = toHast(mdast)
+  let html = toHtml(hast, {
+    closeSelfClosing: true,
+  })
+
+
+  const title = file.replace('/index.md', '').replace('.md', '').split('/').reverse()[0]
+
+
+  const content = await confluence.content.getContent({
+    spaceKey: config.space,
+    title,
+  })
+
+  let version = 1
+if (content.results.length > 0) {
+  let id = content.results[0].id
+  const getContentById = await confluence.content.getContentById({
+    id
+  })
+  version = getContentById.version.number + 1
+}
+  html = html.replace(/<img src="(.*?)" \/>/g, '<ac:image><ri:attachment ri:filename="$1" /></ac:image>')
+
+
+  let id = null;
+  const parent = file.replace('/index', '').split('/').reverse()?.[1]
+  let parentId = configFile?.parent_id
+  if (parent) {
+    const parentContent = await confluence.content.getContent({
+      spaceKey: config.space,
+      title: parent,
+    })
+    console.log(`Parent: ${parent}`)
+    parentId = parentContent.results[0].id
+  }
+  if (content.results.length === 0) {
+    console.log(`Create content: ${file}`)
+    const newPage = await new Promise(r => confluence.content.createContent({
+      space: {
+        key: config.space
+      },
+      title,
+      type: 'page',
+      body: {
+        storage: {
+          value: html,
+          representation: 'storage'
+        }
+      },
+      ancestors: parentId ? [{ id: parentId }] : [],
+      version: {
+        number: version,
+      },
+    }, r))
+    const content = await confluence.content.getContent({
+      spaceKey: config.space,
+      title,
+    })
+
+
+    id = content.results[0].id
+    if (assets.length) {
+      await confluence.contentAttachments.createOrUpdateAttachments({
+        space: {
+          key: config.space
+        },
+        attachments: await asyncMap(assets, async (asset) => ({
+          file: await readFile(path.join(tempdir + '/.cache/md', asset)),
+          filename: asset,
+          comment: 'Uploaded by exact-gateway',
+          minorEdit: true,
+
+        })),
+        id,
+        version: {
+          number: version,
+        },
+      })
+    }
+  } else {
+    id = content.results[0].id
+
+    if (assets.length) {
+      console.log(version)
+      await confluence.contentAttachments.createOrUpdateAttachments({
+        space: {
+          key: config.space
+        },
+        attachments: await asyncMap(assets, async (asset) => {
+          console.log(asset)
+          return {
+          file: await readFile(path.join(tempdir + '/.cache/md', asset)),
+          filename: asset,
+          comment: 'Uploaded by exact-gateway',
+          minorEdit: true,
+
+        }}),
+        id,
+        version: {
+          number: version,
+        },
+      })
+    }
+  }
+    console.log(`Update content: ${file}`)
+    await confluence.content.updateContent({
+      space: {
+        key: config.space
+      },
+      type: 'page',
+      id: content.results[0].id,
+      version: {
+        number: version
+      },
+      title,
+      body: {
+        storage: {
+          representation: 'storage',
+          value: html
+        }
+      },
+      ancestors: parentId ? [{ id: parentId }] : [],
+    })
+  }