Skip to content
GitLab
Projects Groups Snippets
  • /
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
  • S Solaar
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 10
    • Issues 10
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 2
    • Merge requests 2
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Packages and registries
    • Packages and registries
    • Package Registry
    • Infrastructure Registry
  • Monitor
    • Monitor
    • Incidents
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Repository
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • pwr-Solaar
  • Solaar
  • Merge requests
  • !487

Use automated GitHub pages for documentation

  • Review changes

  • Download
  • Email patches
  • Plain diff
Merged Administrator requested to merge github/fork/Chris-Johnston/master into master Jan 02, 2019
  • Overview 8
  • Commits 4
  • Pipelines 0
  • Changes 18

Created by: Chris-Johnston

Fix #479 (closed) , updates the index page with the most recent readme.

Hello, I was looking at fixing issue #479 (closed), when I noticed that the source for https://pwr.github.io/Solaar/ is maintained in the branch gh-pages, and hasn't been updated in 6 years. I considered either editing the static index page manually (which works, but isn't ideal for maintainability), or using the build script provided to update these files (which wasn't working, missing dependencies on my end).

GitHub pages does support building static pages using Jekyll, so I figured that this would be a much more maintainable solution. The site content can be updated whenever new changes are pushed to master, without any sort of manual steps.

There is one slight downside to this: The contents of the README.md cannot be used for the index page, so this file was copied. Maintaining changes to both would be something that would have to be kept in mind. I'm not sure a symbolic link would work here. In addition, some of the files had to have Jekyll front-matter added.

I've also rendered a favicon.png from the logo, since that was one step that was done in the old script.

If this is merged, someone with administrator access to this repo's settings would have to change the source away from the gh-pages branch.

image

I have a preview of these changes available at https://chris-johnston.me/Solaar

Assignee
Assign to
Reviewers
Request review from
Time tracking
Source branch: github/fork/Chris-Johnston/master