Code Monkey home page Code Monkey logo

blog_yosyshq's Introduction

Hugo Source for YosysHQ Blog

Installing Hugo (Unbuntu 20.4 LTS)

$ sudo snap install hugo

Instructions for viewing locally

$ git clone --recursive [email protected]:YosysHQ-GmbH/blog_yosyshq.git
$ cd blog_yosyshq
$ hugo server

Now open the localhost URL that hugo server printed to the console in your browser.

Whenever you safe a change to a file, the perview in your browser is updated in real time.

Instructions for building static files

Simply build the static files and placing them in public/ is easy:

$ hugo -e production

However, if you also want to push your changes it's recommended to use the build.sh script instead (make sure public/ doesn't exist yet when running build.sh for the first time):

$ bash build.sh

Finally, pushing your changes to the life website:

$ bash publish.sh

blog_yosyshq's People

Contributors

mattvenn avatar suarezvictor avatar clairexen avatar korrygan avatar bl0x avatar nakengelhardt avatar thezoq2 avatar neuschaefer avatar lethalbit avatar meiniki avatar polprog avatar

Stargazers

Kazuki Terada avatar

Watchers

 avatar Kazuki Terada avatar  avatar  avatar  avatar  avatar

blog_yosyshq's Issues

Open Graph twitter data

blog_yosyshq/config.yaml

Lines 73 to 79 in 22829e7

opengraph:
twitter:
# Your Twitter username
site:
# Available values: summary, summary_large_image
card: summary_large_image

Should we add Open Graph data? Something like the following:

    opengraph:
        twitter:
            site: @YosysHQ
            card: summary

I don't have a big opinion on summary vs summary_large_image, but I would assume that we will not have a fancy image for most blog posts. So I think it makes sense to go for the layout that shows a bit more of the text.

jfyi, this is a summary card
image

and this is summary_large_image
image

File names and titles and permalinks for blog posts

I find the file and directory names used for the blog posts a bit weird..

press-release.md
Aren't they all press releases? Maybe something like hello-world would be better, also as title for the posts.

white-paper.md
Shouldn't that be more something like appnote-120.md, considering it's the article about that specific app note?

Should we add prefixes to the files so they are sorted chronologically? Maybe something like a directory for each quarter and a 2-digit filename prefix maybe?

/posts/2021Q2/01-hello-world.md
/posts/2021Q2/02-appnote-120.md
...

Right now we are using :slug for permalinks:

blog_yosyshq/config.yaml

Lines 17 to 19 in 22829e7

permalinks:
post: /p/:slug/
page: /:slug/

I think this is good. But we also should include a slug in the front matter of pages and posts. Something like slug: hello and slug: ap120 maybe?

Local build fails on newsletter

hugo server fails with

Watching for changes in /home/frans/Documents/oss/blog_yosyshq/{archetypes,assets,content,static,themes}
Watching for config changes in /home/frans/Documents/oss/blog_yosyshq/config.yaml
Start building sites …
hugo v0.119.0+extended linux/amd64 BuildDate=unknown

Built in 18 ms
Error: error building site: assemble: "/home/frans/Documents/oss/blog_yosyshq/content/page/newsletter.md:7:1": failed to extract shortcode: template for shortcode "mail-chimp" not found

unless I temporarily remove content/page/newsletter.md

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.