Skip to content

Commit 140a27a

Browse files
tutorial resources
1 parent eeffdb5 commit 140a27a

File tree

8 files changed

+46
-2
lines changed

8 files changed

+46
-2
lines changed

Diff for: _data/navigation.yml

+4
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,10 @@ docs:
1616
children:
1717
- title: Local Build
1818
url: /build/local
19+
- title: Github Configuration
20+
url: /build/github
21+
- title: Tutorial
22+
url: /build/tutorial
1923
- title: Using the Building Blocks
2024
children:
2125
- title: Finding Building Blocks

Diff for: _pages/build/github.md

+6-2
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,16 @@
11
# Configuring Github build
22

33
Github repositories need configuration to allow automated building.
4-
4+
1. Fork the template or another repository to a git organisation you have admin access for.
55
1. In settings set "pages build" to "Github actions"
66
![](pages.png)
77
2. Run the "validate and postprocess" action
88
![](run.png)
99
3. Link the generated output pages to the repo overview by selecting "show"
1010
![](link.png)
1111

12-
You can now navigate between repository sources and the published Building Blocks [Watch]()
12+
You can now navigate between repository sources and the published Building Blocks:
13+
14+
![From Repo to docs](to_register.png)
15+
16+
![From Docs to Repo](to_repo.png)

Diff for: _pages/build/link.png

90.1 KB
Loading

Diff for: _pages/build/pages.png

100 KB
Loading

Diff for: _pages/build/run.png

92.8 KB
Loading

Diff for: _pages/build/to_register.png

70 KB
Loading

Diff for: _pages/build/to_repo.png

171 KB
Loading

Diff for: _pages/build/tutorial.md

+36
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# Building Blocks Tutorials
2+
3+
A range of tutorials will provide step by step introduction to the features of OGC Building Blocks.
4+
5+
Please raise an [issue](https://github.com/ogcincubator/bblocks-docs/issues) for new tutorial requests
6+
7+
## Tutorials
8+
9+
### [Core](https://ogcincubator.github.io/bblocks-tutorial/)
10+
11+
This steps through the core features of the OGC Building Blocks framework with an emphasis on OGC API ready, semantically enabled JSON schemas.
12+
13+
14+
## Planned tutorials
15+
16+
### Governance
17+
18+
A description of various governance patterns and an introduction to OGC Policies and Procedures in relation to Building Blocks.
19+
20+
### Building interoperable metadata profiles (STAC, Records, 19115, DCAT etc)
21+
22+
This will focus on metadata design and the various extension and profiling mechanisms for metadata standards relevant to the OGC mission.
23+
24+
Transformations and testing will be a key aspect due to the variations schemas and encoding technologies in use.
25+
26+
### Data transformations
27+
28+
Transformations will be a constant challenge, and a wide range of transformation languages and tools may be needed - this tutorial will show options and how to extend the framework to include your own transformation tools.
29+
30+
### Semantic Model Publishing
31+
32+
Publishing semantic (RDF, OWL, SHACL) etc models is difficult due to limitations of existing tools. This tutorial will demonstrate how to factor semantic models into FAIR building blocks and make the model itself FAIR.
33+
34+
### UML models
35+
36+
UML models are notoriously difficult to manage in a modular fashion - this tutorial will focus on FAIR UML models - composition and testing.

0 commit comments

Comments
 (0)