Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
37f4aff
feat: create markdown version of the trust meter indroduction google doc
klown Feb 25, 2026
30314d7
Ignore generated files.
jasonjgw Feb 26, 2026
38351a7
Add a basic makefile to generate HTML, PDF and Office Open XML/Microsoft
jasonjgw Feb 27, 2026
6b6d83b
Add title and author metadata.
jasonjgw Feb 27, 2026
67cc939
Use separator (<HR>) syntax accepted by Pandoc.
jasonjgw Feb 27, 2026
d675cb2
Add editorconfig file.
jasonjgw Feb 28, 2026
5023fdf
Convert the document to Markdown again, this time without line wrapping.
jasonjgw Mar 1, 2026
676227f
Add title again after file format conversion.
jasonjgw Mar 1, 2026
f470037
Enable section numbering for ease of reference. Clarify the makefile.
jasonjgw Mar 2, 2026
bc744a2
Correct heading levels in the Definitions section.
jasonjgw Mar 2, 2026
5982d49
Use correct separator markup in the cover note.
jasonjgw Mar 2, 2026
71365ff
Refine makefile by implementing the more useful suggestions in a code
jasonjgw Mar 5, 2026
46a2dcd
Update README to document the build process.
jasonjgw Mar 5, 2026
76c444a
Ignore .DS_Store directory created on macOS systems.
jasonjgw Mar 5, 2026
8964faa
Remove the draft, which will be maintained in a separate branch until…
jasonjgw Mar 5, 2026
71319c7
Place generated files in an output directory.
jasonjgw Mar 5, 2026
3d15b91
Actually create the destination directory, and remove it when cleaning.
jasonjgw Mar 6, 2026
b06ecdc
Simplify directory creation.
jasonjgw Mar 6, 2026
d1762b0
Suppress make errors if the destination directory already exists.
jasonjgw Mar 6, 2026
b3379e6
Document how to continue processing the makefile if TeX (needed for PDF
jasonjgw Mar 6, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions .editorconfig
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
root = true
[*]
end_of_line = lf
insert_final_newline = true
charset = utf-8

[*.md]
indent_style = space

3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
.DS_Store
dist

Comment thread
klown marked this conversation as resolved.
32 changes: 32 additions & 0 deletions Makefile
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
# Generate documents in the desired output formats.

# Identify source and target files.
destination=dist/
exclusions:=README.md
sources:=$(filter-out $(exclusions), $(wildcard *.md))
html_targets:=$(patsubst %.md, $(destination)%.html, $(sources))
pdf_targets:=$(patsubst %.md, $(destination)%.pdf, $(sources))
docx_targets:=$(patsubst %.md, $(destination)%.docx, $(sources))

# Options
pandoc_options:=-s -N

# Implicit rules
$(destination)%.html : %.md $(destination)
pandoc $(pandoc_options) $< -o $@
$(destination)%.pdf : %.md $(destination)
pandoc $(pandoc_options) $< -o $@
$(destination)%.docx : %.md $(destination)
pandoc $(pandoc_options) $< -o $@

# Targets
.PHONY: all html pdf docs clean
all: html pdf docx
html: $(html_targets)
pdf: $(pdf_targets)
docx: $(docx_targets)
clean:
rm -rf $(destination)
$(destination):
mkdir -p $(destination)

12 changes: 11 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,11 @@
# trust-meter
# Trust meter Documents
This repository contains work of the Trust meter Technical Committee.

# Software Prerequisites
Documentation is written in Pandoc Markdown. Pandoc and GNU Make are required to build rendered versions using the included makefile. A TeX installation is also necessary if PDF output is desired. HTML, PDF and Office Open XML/Microsoft Word format are generated by default when `make` is run.
Comment thread
klown marked this conversation as resolved.

If TeX is not installed and PDF output is not considered necessary, you can run `make -k` to continue processing the makefile despite the failure of the PDF target.

# Copyright
[Add license details and copyright information.]