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

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions