https://github.com/fomightez/gohugo-binder

Go-based static site generator HUGO running via binder served sessions.
https://github.com/fomightez/gohugo-binder

Last synced: 8 days ago
JSON representation

Go-based static site generator HUGO running via binder served sessions.

• Host: GitHub
• URL: https://github.com/fomightez/gohugo-binder
• Owner: fomightez
• License: mit
• Created: 2020-01-14T20:20:44.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2021-07-12T18:59:50.000Z (over 3 years ago)
• Last Synced: 2024-11-07T14:13:23.748Z (about 2 months ago)
• Language: Jupyter Notebook
• Size: 40 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# gohugo-binder

[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/fomightez/gohugo-binder/master?filepath=index.ipynb)

Go-based static site generator HUGO running via binder served sessions.

------

An introductory notebook that steps through a quick start with [Hugo](https://gohugo.io/) opens upon session launch.

Step through the introductory notebook to see how to use Hugo in sessions launched from here.

Technical details

-----------------

- Hugo  

	Apt install only is getting version 0.40. So don't use `apt.txt` as route to install. The `postBuild` file in this repo details the approach because the documented install presently listed for Linux isn't compatible with MyBinder/Binder. On the postive side the installation is easy once you know which route to use because the application itself is rather self-contained.   

	Installed extended version of HUGO as [Docsy](https://themes.gohugo.io/docsy/) theme needs that. Also installed postCSS following 'Prerequisites' for Docsy theme listed [here]( https://themes.gohugo.io/docsy/).

- Go  

	This repo results in a system with current version (go1.13.6 when enter `go version` in the terminal) of Go language on it. This is important because athough you can use `apt.txt` to install the go language, as based on [here](https://github.com/aborruso/bashnotebook/blob/master/binder/apt.txt), that currently is way beyond (version 1.10 something). **I didn't realize until later that you only need Go installed if you are compiling Hugo from source**, see [here](https://discourse.gohugo.io/t/quick-start-doesnt-work-on-ubuntu/14686/2). However, leaving here because nice to have installation of current Go language worked out for the MyBinder.org/Binder system, and I may think 'Go language' when I think of 'Hugo'. Later moved what I learned about Go installation in the MyBinder.org/Binder system to [my fork of pixterm](https://github.com/fomightez/pixterm/) to binderize it, because that one indeed says you need the compiler [here](https://github.com/eliukblau/pixterm#installation).

----

[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/fomightez/gohugo-binder/master?filepath=index.ipynb)