Show HN: Makesite – A static site generator in 125 lines of Python • Hacker News Board

Show HN: Makesite – A static site generator in 125 lines of Python

#1

Post by sunainapai » Sat, Mar 17, 2018, 11:03 AM UTC

Show HN: Makesite – A static site generator in 125 lines of Python
github.com

Re: Show HN: Makesite – A static site generator in 125 lines of Python

#2

Post by foo101 » Sat, Mar 17, 2018, 11:33 AM UTC

This seems to use the commonmark library to render Markdown? Can it render Pandoc flavour of Markdown?

How widespread commonmark really is? Any popular sites using it? If I write my blog posts in commonmark is it safe to assume site generation tools 10 years from now will correctly render commonmark?

Re: Show HN: Makesite – A static site generator in 125 lines of Python

#3

Post by est » Sat, Mar 17, 2018, 12:07 PM UTC

generate static site with 1 line of shell command

    echo "" > index.html

Re: Show HN: Makesite – A static site generator in 125 lines of Python

#4

Post by reificator » Sat, Mar 17, 2018, 12:18 PM UTC

foo101 wrote: post #2

This seems to use the commonmark library to render Markdown? Can it render Pandoc flavour of Markdown? How widespread commonmark really is? Any popular sites using it? If I write my blog posts in commonmark is it safe to assume site generation tools 10 years from now will correctly render commonmark?

The main competitor to CommonMark is GFM, which is now based on CommonMark.

https://githubengineering.com/a-formal-spec-for-github-markd...

Re: Show HN: Makesite – A static site generator in 125 lines of Python

#5

Post by Philipp__ » Sat, Mar 17, 2018, 12:31 PM UTC

Hugo is still most convenient, at least for me and my workflow. I just pull it with homebrew, created my theme/template, write blogposts in Emacs org-mode (using ox-hugo), host it on GH pages for free, and use custom domain and free tier cloudflare.

I am really enjoying bare essentials I got, very streamlined process that does the job for me. This looks interesting, I really like minimalist aspects of software, but what ain't broken don't fix it.

Re: Show HN: Makesite – A static site generator in 125 lines of Python

#6

Post by secura » Sat, Mar 17, 2018, 12:32 PM UTC

est wrote: post #3

generate static site with 1 line of shell command echo " " > index.html

Is this a valid HTML? https://validator.w3.org/ seems to require this as minimal HTML to validate successfully.

I would thus fix your 1 line shell static site generator like this.

    echo '0' > index.html

Re: Show HN: Makesite – A static site generator in 125 lines of Python

#7

Post by butz » Sat, Mar 17, 2018, 12:52 PM UTC

secura wrote: post #6

est wrote: post #3

generate static site with 1 line of shell command echo " " > index.html

Is this a valid HTML? https://validator.w3.org/ seems to require this as minimal HTML to validate successfully. 0 I would thus fix your 1 line shell static site generator like this. echo ' 0 ' > index.html

You can trim tag and still get valid html: 0

Re: Show HN: Makesite – A static site generator in 125 lines of Python

#8

Post by devposter » Sat, Mar 17, 2018, 1:08 PM UTC

Philipp__ wrote: post #5

Hugo is still most convenient, at least for me and my workflow. I just pull it with homebrew, created my theme/template, write blogposts in Emacs org-mode (using ox-hugo), host it on GH pages for free, and use custom domain and free tier cloudflare. I am really enjoying bare essentials I got, very streamlined process that does the job for me. This looks interesting, I really like minimalist aspects of software, but w…

Hugo is nice and extremely fast. But one thing that I find unintuitive in Hugo is how the layout files are arranged. I can never remember them without referring to the documentation or the source files of an existing Hugo site everytime I need to create a new Hugo site.

For example, the base layout template needs to go to themes//layouts/_default/base.html but the layout for a blog needs to go to themes//layouts//single.html. Then there is list type layout too to define the blog index pages. Is the home page a single page or a list page? Can the entire home page be defined as a base template? It gets confusing.

Then the whole {{ define }} and {{ block }} syntax to embed one template in another is quite unintuitive as well. I think Jekyll has much more sane layout that is easy to keep in head. Also in Jekyll one can define list pages without any special naming convention just by using its templating for-loops. I find Hugo less intuitive than others but the fact that Hugo does not require me to learn Ruby is a win.

Custom written shell commands or Python code or even plain SSI includes are a great way to host static content too.

Re: Show HN: Makesite – A static site generator in 125 lines of Python

#9

Post by paulgb » Sat, Mar 17, 2018, 1:20 PM UTC

Philipp__ wrote: post #5

Hugo is still most convenient, at least for me and my workflow. I just pull it with homebrew, created my theme/template, write blogposts in Emacs org-mode (using ox-hugo), host it on GH pages for free, and use custom domain and free tier cloudflare. I am really enjoying bare essentials I got, very streamlined process that does the job for me. This looks interesting, I really like minimalist aspects of software, but w…

Another free solution that may involve even less setup is Netlify's free tier, which includes 1-click HTTPS setup on a custom domain and reruns Hugo every time you push to the repo.

Re: Show HN: Makesite – A static site generator in 125 lines of Python

#10

Post by cryptoz » Sat, Mar 17, 2018, 2:08 PM UTC

secura wrote: post #6

est wrote: post #3

generate static site with 1 line of shell command echo " " > index.html

Is this a valid HTML? https://validator.w3.org/ seems to require this as minimal HTML to validate successfully. 0 I would thus fix your 1 line shell static site generator like this. echo ' 0 ' > index.html

It's still a site even if it doesn't validate. HN (news.ycombinator.com) generates more than 100 errors on that validator. Doesn't mean HN isn't a site.