dev.to 및 medium.com에서 GitHub 워크플로로 기사 배포

소개

이 글은 우리 프로그래머를 둘러싼 게으름에서 탄생했습니다.

핵심 개념은 다음과 같은 건설적인 게으름입니다.

두 번 이상 수행해야하는 경우 프로세스를 자동화하십시오 ...

제 필요는 가장 빠르고 쉬운 방법으로 기사를 작성할 수 있으면서도 여러 플랫폼에서 복제할 수 있어야 한다는 것입니다.
그래서 기사가 포함된 Markdown 파일을 사용하여 dev.to 및 medium.com에 게시할 수 있는 방법을 찾기 시작했습니다.

다행히도 종종 그렇듯이 누군가 나보다 먼저 생각하고 솔루션을 구현했습니다.
오픈소스의 아름다움!

https://github.com/protiumx/blogpub/tree/v0.4.1

구현

기사의 출처가 포함된 저장소를 볼 수 있습니다.

https://github.com/FabrizioCafolla/blog

블로그 폴더 내부의 구조는 매우 간단합니다. 여기에는 .md 확장자로 작성된 모든 기사가 있습니다. 예를 들면 다음과 같습니다.

    ---
    title: "Example"
    description: "Exmpale desc. "
    tags: tag1, tag2, tag3, tag4, tag5
    ---

    # Title

    Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book.

    ![image](https://raw.githubusercontent.com/FabrizioCafolla/blog/main/posts/001/images/img.png) ==> ![image](https://raw.githubusercontent.com/<owner>/<repo>/<articles_folder>/images/img.png)

파일 내부에 헤더가 필요하다는 것을 기억하십시오(자세한 정보see here). 그런 다음 저장소의 이미지를 참조하는 경우 예제에서와 같이 렌더링되는 이미지를 포함하여 마크다운의 모든 기능을 사용할 수 있습니다.

이제 두 플랫폼 모두에서 파이프라인으로 문서를 배포하려면 다음 경로 .github/workflows의 리포지토리 내부에 파일을 생성해야 합니다. 파일 이름은 무관하며 내부에 삽입해야 합니다.

name: Publish articles

on:
  push:
    branches: [main]

jobs:
  publish:
    name: Publish blog
    runs-on: ubuntu-20.04   
    steps:
      - name: Checkout
        uses: actions/checkout@v2

      - name: Deploy
        uses: protiumx/[email protected]
        with:
          articles_folder: %PATH%
          devto_api_key: $
          gh_token: $
          medium_token: $
          medium_user_id: $

기사가 포함된 경로를 %PATH% 대신 삽입해야 합니다. 제 경우에는 단순히 게시물입니다.

GitHub에서 리포지토리를 생성하고 업로드한 후에는 파이프라인이 플랫폼의 API에 연결할 수 있도록 비밀을 삽입해야 합니다. 그런 다음 다음 키를 입력합니다.

DEVTO_TOKEN: dev.to에서

MEDIUM_TOKEN: 중간

에서 generate token

MEDIUM_ID: get user id API의 매체

비밀을 삽입하고 기사를 작성하면 배포 파이프라인이 기본에 의해서만 실행되며 원하는 대로 변경할 수 있습니다.

고려 사항

첫 번째 고려 사항은 게시 후 수정의 경우 기사 업데이트가 어떻게 작동하는지 아직 잘 이해하지 못한다는 것입니다.

두 번째 고려 사항은 단일 소스에서 이 프로세스를 사용하면 간단하고 쉽게 여러 플랫폼에 게시할 수 있다는 것입니다. 언젠가 다른 사이트에 게시하고 싶다면 파이프라인만 변경하면 됩니다.