Skip to content

Create trace-vocabularies repo to serve as hub for TRACE vocabularies #20

@tmcphillips

Description

@tmcphillips

Note: Supersedes #14, taking a submodule approach per @Xarthisius's suggestion.

Summary

Create a new trace-vocabularies repo that aggregates TRACE-sponsored vocabularies as git submodules and provides shared infrastructure: Widoco build, GitHub Pages deployment, w3id.org redirect configuration, and a vocabulary index page.

Individual vocabulary repos (beginning with trov) contain only vocabulary source files. The trace-vocabularies repo builds and publishes documentation and generated serializations (.jsonld, .rdf, .nt) for all of them.

Structure

trace-vocabularies/
├── trov/          → submodule → transparency-certified/trov
├── w3id/
│   ├── .htaccess
│   ├── README.md
│   └── tests/
├── widoco/
│   ├── Dockerfile
│   ├── README.md
│   └── tests/
└── .github/
    └── workflows/
        └── deploy.yml

Steps

  • Create trace-vocabularies repo under transparency-certified org
  • Add trov as submodule
  • Add w3id/ directory (.htaccess, README.md, tests)
  • Add widoco/ directory (Dockerfile, README.md)
  • Create GitHub Action that builds docs from submodules and deploys to Pages
  • Enable GitHub Pages
  • Verify transparency-certified.github.io/trace-vocabularies/trov/0.1/
  • Remove w3id/ from trov repo

Related

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions