Skip to content

Commit

Permalink
Add screenshots, adjust titles #34
Browse files Browse the repository at this point in the history
  • Loading branch information
sroertgen committed Mar 20, 2024
1 parent c7cac62 commit 7b8d8a7
Show file tree
Hide file tree
Showing 5 changed files with 17 additions and 11 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
28 changes: 17 additions & 11 deletions content/blog/2024-03-20-skohub-pages/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,32 +8,38 @@ authors: [{lastname: "Rörtgen",

## A simple workflow for publishing your SKOS vocab

With [SkoHub Pages](https://github.com/skohub-io/skohub-pages) we now provide a very simple way for publishing your SKOS vocabulary from a GitHub repository. It only involves 5-6 steps.
With [SkoHub Pages](https://github.com/skohub-io/skohub-pages) we now provide a very simple way for publishing your SKOS vocabulary from a GitHub repository. It only involves 5-6 steps:

### Fork the skohub-pages repo.
### 1 Fork the skohub-pages repo.

**Uncheck the box to only fork the main branch**.
⚠️ **Uncheck the box to only fork the main branch**.

![Create fork, uncheck to only fork main branch](./create_fork.png)

### Activate GitHub Actions
### 2 Activate GitHub Actions

Go to "Actions" tab and if not already activated, activate GitHub Actions.

### Configue GitHub Pages branch
### 3 Configue GitHub Pages branch

Go to "Settings", navigate to the "Pages" setting and select `gh-pages` as the branch your site is being built from.
Go to "Settings", navigate to the "Pages" setting and select `gh-pages` as the branch your site is being built from.

## Update pages URL
![Set gh-pages branch](./set_gh_pages.png)

### 4 Update pages URL

Go back to the main page of your repo and click the little gear icon in the top right of the "About" section. Check the box at "Use your GitHub Pages website".

## Start committing
![Edit "About" section of the repository](./click_gear_icon.png)
![Set URL of repository](./use_gh_pages_website.png)

### 5 Start committing

Add a commit to the main branch and your vocabulary will be automatically published (sometimes it takes a little to see the changes, remember to do some hard refreshing).

## Set your GitHub Pages URL as namespace
### (6) Set your GitHub Pages URL as namespace

See below
See section "Resolving custom domains" below ⬇️


## Utilizing GitHub Actions & Pages
Expand Down Expand Up @@ -106,4 +112,4 @@ Feel free to try out our simplified approach and let us know if something does n

## Outlook: Supporting other forges

There are lots of reasons why people might not want to use GitHub infrastructure owned by Microsoft for their SKOS publication workflows. That's why we will be looking into replacing as much as possible by generic git-based tooling for triggering the build and will think about providing alternatives for building vocabs on Microsoft servers: https://github.com/skohub-io/skohub-pages/issues/19
There are lots of reasons why people might not want to use GitHub infrastructure owned by Microsoft for their SKOS publication workflows. That's why we will be looking into replacing as much as possible by generic git-based tooling for triggering the build and will think about providing alternatives for building vocabs on Microsoft servers: https://github.com/skohub-io/skohub-pages/issues/19
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 7b8d8a7

Please sign in to comment.