rlsbl v0.40.1 /rlsbl.targets.docs
Updated
On this page

Docs release target that delegates entirely to the selfdoc CLI, detecting selfdoc.json projects and routing build and deploy through selfdoc.

#rlsbl.targets.docs

#rlsbl.targets.docs

Docs target -- thin wrapper delegating to the selfdoc CLI so rlsbl can detect, build, and deploy selfdoc documentation sites without duplicating any of selfdoc's logic.

Detection is based on the presence of selfdoc.json in the project root. Build and deploy are delegated entirely to the selfdoc CLI tool.

#DocsTarget

Release target that delegates documentation to selfdoc.

#name

python
def name(self)

#_selfdoc_available

python
def _selfdoc_available(self)

Return True if the selfdoc CLI is installed and runnable.

#detect

python
def detect(self, dir_path)

True if selfdoc.json exists in the given directory.

#read_version

python
def read_version(self, dir_path)

Docs don't have their own version -- return fallback.

#write_version

python
def write_version(self, dir_path, version)

No-op: docs inherit version from primary target.

#version_file

python
def version_file(self)

No version file -- docs inherit from primary target.

#tag_format

python
def tag_format(self, version)

No separate tag -- uses primary target's tag.

#build

python
def build(self, dir_path, version)

Delegate to selfdoc build.

#publish

python
def publish(self, dir_path, version)

Delegate to selfdoc deploy, gated by per-target config and credentials.

Behaviour:

  • config local=false: skip with message
  • config local=true and selfdoc missing: error
  • config local=true and selfdoc present: run selfdoc deploy
  • no config: only attempt if both CF_ACCOUNT_ID and CF_PAGES_API_TOKEN

are set (and selfdoc is available); otherwise skip silently