Ryhti-hankkeen piiriin kuuluvien rakennetun ympäristön tietomallien yhteinen dokumentaatiosivusto. Sivustoa hallinnoi Suomen ympäristökeskus, ja tietomallien muutoshallintaprosessista vastaa ympäristöministeriö.
Dokumentaatio on koottu pääosin tämän repon wikiin, ks. muun muassa sivut
RY-tietomallit sivusto on rakennettu siten, että sen sisältö koostuu pääosin toisista git-repoista noudettavista lähdekooditiedostoista. Linkitys ry-tietomallit-reposta toisiin git-repoihin on toteutettu git submodule-mekanismilla. Näin voidaan esittää samalla sivustolla useamman kuin yhden tietomallin version kuvaus linkittämällä ko. tietomallirepon eri release-tagien mukaisiin committeihin, ks. lisää wiki-sivu Tietomallien kehittäminen ja ylläpito.
Sivulle voidaan linkittää mitä tahansa julkisia git-repoja, ja GitHub Pages -osaa noutaa ko. linkkien asetetun commitin mukaiset sisällöt automaattisesti sivuston buildauksen yhteydessä. Huom: Mikäli moduli ei ole julkaistu GitHub:issa, sen sivumetatieto-laatikon muutostietojen esittäminen ei onnistu, sillä sen tiedot haetaan JavaScriptillä käyttäen GitHub REST APIa.
Kulloinkin linkatut git submodulet ja niiden tilan saa tulostettua (linux-tyyppisessä komentoriviympäristössä) seuraavalla loitsulla:
$ git submodule foreach --quiet 'printf "\n$sm_path: linked to " && git remote get-url origin && printf "at " && git describe --tags --first-parent --dirty --always'
Seuraavassa listassa on lueteltu rakennetun ympäristön yhteentoimivuustyössä tunnistettuja tietomalleja, jotka on tarkoitus tuoda sivustolle omina moduleinaan tulevaisuudessa:
Sivuston kehittämisessä on huomattavasti hyötyä paikallisesta kehitysympäristöstä, jossa tietoihin tehtävät muutokset saa näkyviin esikatseluna ilman tietojen viemistä GitHub Pages - mekanismilla julkaistulle Rakennetun ympäristön tietomallit-sivustolle.
Mikäli valmistelet uutta versiota kehitettävästä tietomallista tai uutta sivustolle tuotavaa tietomallia, noudata sisältörepojen kehittämis- ja ylläpito-ohjetta tämän repon wikissä.
GitHub Pages -sivugenerointia voi simuloida varsin uskottavasti paikallisella työasemalla ajaen Docker GitHub Pages -Docker-konttia:
$ git clone https://github.com/<oma-gh-tunnus>/ry-tietomallit.git
$ git submodule init;
$ git submodule update;
ry-tietomallit/docs
$ docker run -it --rm -v "$PWD":/usr/src/app -p "4000:4000" starefossen/github-pages
git restore
-komennolla, ja tehdä pull ry-tietomallit -repon paikallisen klooniin ko. modulin hakemistossa.