Skip to content

action-doctum

Actions
Use Doctum without having to install it
v5
Latest
Star (3)

A GitHub action to run Doctum

Series Badges
5.x Build docker image build doctum docs
dev Build docker image build doctum docs
latest Build docker image build doctum docs

Go to Doctum at GitHub

You can find the image on Docker Hub

Docker Pulls

Example usage for 5.x series

  - uses: actions/checkout@v4
  - name: build doctum docs
    uses: sudo-bot/action-doctum@v5
    with:
        config-file: doctum.php
        # parse, render or update
        method: "update"
        # (optional) defaults to '--output-format=github --no-ansi --no-progress -v'
        cli-args: "--output-format=github --no-ansi --no-progress -v"

Example usage for latest series

  - uses: actions/checkout@v4
  - name: build doctum docs
    uses: sudo-bot/action-doctum@latest
    with:
        config-file: doctum.php
        # parse, render or update
        method: "update"
        # (optional) defaults to '--output-format=github --no-ansi --no-progress -v'
        cli-args: "--output-format=github --no-ansi --no-progress -v"

Example usage for dev series

  - uses: actions/checkout@v4
  - name: build doctum docs
    uses: sudo-bot/action-doctum@dev
    with:
        config-file: doctum.php
        # parse, render or update
        method: "update"
        # (optional) defaults to '--output-format=github --no-ansi --no-progress -v'
        cli-args: "--output-format=github --no-ansi --no-progress -v"

Example for a zero-config setup to parse/lint phpdocs

name: Lint phpdocs

on: [push]

jobs:
  lint-phpdoc:
    name: lint-phpdoc
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Create a config file
        # Scan all the src folder
        run: echo "<?php return new Doctum\Doctum('src/');" > doctum-config.php
      - name: lint doctum docs
        uses: sudo-bot/action-doctum@v5
        with:
          config-file: doctum-config.php
          method: "parse"
          # (optional) defaults to '--output-format=github --no-ansi --no-progress -v'
          cli-args: "--output-format=github --no-ansi --no-progress -v"

action-doctum is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

About

Use Doctum without having to install it
v5
Latest

action-doctum is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.