action.yml

name: 'md2zhihu'
description: >
  Convert markdown to a single-file by uploading local assets.

branding:
  icon: upload-cloud
  color: green

inputs:
  pattern:
    description: 'file pattern to convert'
    required: true
    default: '**/*.md'

  output_dir:
    description: |-
      dir to store converted markdown.
    required: true
    default: '_md2zhihu'

  asset_repo:
    description: |-
      Specify the git repo for asset storage.

      The converted markdown will reference images in this repo. Supported providers include `github.com` and `gitee.com`.
      When this option is absent, assets are pushed to the current repo `https://github.com/{{ github.repository }}.git`.

      To push assets to `gitee.com`:

      1. On gitee.com, create a access token at https://gitee.com/personal_access_tokens, to enable pushing assets to gitee.com;
         The token must enable `projects` privileges.

      2. Add a secret to the GitHub markdown repository that contains your gitee.com username and token (e.g., `GITEE_AUTH=drdrxp:abcd...xyz`) at `https://github.com/<username>/<repo>/settings/secrets/actions`.

      3. Set `asset_repo` to the gitee.com repo push URL with the auth token, such as:
         `asset_repo: https://[dollar]{{ secrets.GITEE_AUTH }}@gitee.com/drdrxp/bed.git`

    required: false
    default: 'https://github.com/${{ github.repository }}.git'

  asset_branch:
    description: |-
      The branch in which assets are stored.
      The converted markdown references images at this location.
      This branch must NOT be removed otherwise the assets will not be accessed.
    required: true
    default: '${{ github.ref_name }}-md2zhihu-asset'

  target_platform:
    description: |-
      The platform that the converted markdown should be compatible to.

      Currently supported platforms are zhihu, wechat, weibo, simple.
      `simple` converts almost everything to images and removes most text styles.
      E.g. inline code block is converted to normal text.

    required: true
    default: 'zhihu'

  output_branch:
    description: |-
      Commit and push the "output_dir" to a branch of this repo.
      Set this to "" to disable push, in which case, user commit and push it manually.

    required: true
    default: '${{ github.ref_name }}-md2zhihu'

outputs:
  converted_branch:
    description: "The url of the branch of converted markdowns"
    value: ${{ steps.convert.outputs.converted_branch }}
runs:
  using: "composite"
  steps:
    - name: Add npm bin into PATH
      shell: bash
      run: |
        echo "add node module path: $GITHUB_WORKSPACE/node_modules/.bin/"
        echo "$GITHUB_WORKSPACE/node_modules/.bin/" >> $GITHUB_PATH


    - name: Install mermaid
      shell: bash
      run: |
        npm install --verbose @mermaid-js/mermaid-cli@10.2.2
        echo "locate npm, mmdc and mmdc --version"
        which npm
        which mmdc
        mmdc --version


    - name: Install pandoc
      shell: bash
      run: |
        sudo apt-get install pandoc
        pandoc --version

    - name: Install graphviz
      shell: bash
      run: |
        sudo apt-get install graphviz
        dot -V

    - name: Install python dep in requirements.txt
      shell: bash
      run: |
        pip3 install setuptools wheel
        pip3 install -r ${{ github.action_path }}/requirements.txt

    - name: convert
      id: convert
      run: |
        cp -R ${{ github.action_path }} md2zhihu

        echo 'asset_repo: ${{ inputs.asset_repo }}'

        echo "which mmdc"
        which mmdc
        mmdc --version

        python3 -m md2zhihu \
          --repo '${{ inputs.asset_repo }}@${{ inputs.asset_branch }}' \
          --code-width 600 \
          --platform ${{ inputs.target_platform }} \
          --md-output ${{ inputs.output_dir }}/ \
          ${{ inputs.pattern }}

        rm -rf ./md2zhihu

        if [ ".${{ inputs.output_branch }}" == "." ]; then
          echo "output branch is empty, skip push"
        else
          git add ${{ inputs.output_dir }}

          if git diff-index --quiet HEAD --; then
            echo "Nothing to commit"
          else
            git \
              -c "user.name=drmingdrmer" \
              -c "user.email=drdr.xp@gmail.com" \
              commit \
              -m "md2zhihu built"
          fi

          git push -f origin HEAD:refs/heads/${{ inputs.output_branch }}

          echo "::set-output name=converted_branch::https://github.com/${{ github.repository }}/tree/${{ inputs.output_branch }}"
        fi
      shell: bash