mariano/soleprint
Public Access
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

site emitter

Browse Source
This commit is contained in:
buenosairesam
2026-09-12 07:08:00 -03:00
parent 7cb892ccfe
commit 358b98f826
6 changed files with 619 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
soleprint/atlas2/docgen/Makefile
View File

@@ -31,7 +31,7 @@ DEPTH ?= 2
THEME_ARG := $(if $(THEME),--theme $(THEME))
.PHONY: help check ir db graph index view self doctor clean
.PHONY: help check ir db graph index site view self doctor clean
help: ## List every target
@echo "docgen — static analysis of a tree, and the artifacts that fall out of it"
@@ -65,6 +65,11 @@ graph: view ## OUT/view.json -> whatever its structure asks for
@$(RUN) $(PKG).emitters auto $(OUT)/view.json -o $(OUT) \
--style $(STYLE) $(THEME_ARG)
site: view ## OUT/view.json -> a self-contained docs site in OUT/site
@$(RUN) $(PKG).emitters site $(OUT)/view.json -o $(OUT)/site \
--style $(STYLE) $(THEME_ARG)
@echo " open $(OUT)/site/index.html"
index: ## OUT/ir.json -> OUT/index.md and OUT/sidebar.json
@$(RUN) $(PKG).emitters index $(OUT)/ir.json -o $(OUT)/index.md
@$(RUN) $(PKG).emitters index $(OUT)/ir.json -o $(OUT)/sidebar.json
@@ -73,8 +78,9 @@ self: ## Run the whole pipeline over soleprint itself — the honest end-to-end
@$(MAKE) --no-print-directory ir SRC=$(PARENT)/.. OUT=$(OUT)
@$(MAKE) --no-print-directory index OUT=$(OUT)
@$(MAKE) --no-print-directory graph OUT=$(OUT)
@$(MAKE) --no-print-directory site OUT=$(OUT)
@echo
@echo " Read $(OUT)/index.md — it should read like the system."
@echo " Read $(OUT)/index.md, or open $(OUT)/site/index.html"
doctor: ## Report whether this machine can run it
@printf 'python : '; $(PY) --version 2>&1 || echo MISSING