Tranquilpeak — A gorgeous responsive theme for Hugo blog framework

Tranquilpeak — A gorgeous responsive theme for Hugo blog framework


Hugo version of Tranquilpeak is a based on original Hexo version This version is simply a port to Hugo static site generator.

Please all the credit should be attributed to original Hexo version and its author Louis Barranqueiro.

Hugo version keeps every .js and .css files untouched from original Hexo version in order to enjoy futur original Hexo version updates or features!


Quick start

Authors: Louis Barranqueiro (LouisBarranqueiro) and Thibaud Leprêtre (kakawait)
Version: 0.3.1-BETA (based on Hexo version 1.9.1)
Compatibility: Hugo v0.20.1

General features:

Fully responsive
Optimized for tablets & mobiles
Configurable menu of the sidebar
Pages to filter tags, categories and archives
Background cover image
Beautiful about page
Support Open Graph protocol
Easily customizable (fonts, colors, layout elements, code coloration, etc..)
Support internationalization (i18)
Posts features:

Thumbnail image
Cover image
Responsive videos & images
Sharing options
Navigation menu
GitHub theme for code highlighting (customizable)
Image gallery
Tags for images (FancyBox), wide images, tabbed code blocks, highlighted text, alerts
Table of contents
Integrated services:

Google analytics
Facebook Insights

Academic — Create a beautifully simple personal or academic website

Academic — Create a beautifully simple personal or academic website

Academic is a framework to help you create a beautiful website quickly. Perfect for personal, student, or academic websites. Check out the latest demo of what you’ll get in less than 10 minutes.

Key features:

Easily manage your homepage, blog posts, publications, talks, and projects
Configurable widgets available for Biography, Publications, Projects, News/Blog, Talks, and Contact
Need a different section? Just use the Custom widget!
Write in Markdown for easy formatting and code highlighting, with LaTeX for mathematical expressions
Social/academic network linking, Google Analytics, and Disqus comments
Responsive and mobile friendly
Simple and refreshing one page design
Easy to customize The Decline of Marriage and Rise of New Families The Decline of Marriage and Rise of New Families

Over the past 50 years, a quiet revolution has taken place in this country. Decades of demographic, economic and social change have transformed the structure and composition of the American family. The pre-eminent family unit of the mid-20th century—mom, dad and the kids—no longer has the stage to itself. A variety of new arrangements have emerged, giving rise to a broader and evolving definition of what constitutes a family.

At the center of this transformation is the shrinking institution of marriage. In 1960, 72% of American adults were married. By 2008, that share had fallen to 52%.

Part of this decline is explained by the fact that the average age at which men and women first marry is now the highest ever recorded, having risen by roughly five years in the past half century.1 And part of the decline is attributable to the near tripling in the share of currently divorced or separated—to 14% in 2008 from 5% in 1960.2

Public attitudes toward marriage reflect these dramatic changes. When asked in the new survey if marriage is becoming obsolete, about four-in-ten Americans (39%) say that it is. In a survey of voters conducted by Time magazine in 1978, when the divorce rate in this country was near an all-time high, just 28% agreed that marriage was becoming obsolete.3

Changes in marital patterns have had a major impact on the lives of children in this country. Marriage is no longer considered a prerequisite for parenthood. Over the past 50 years, the share of children born to unmarried mothers has risen dramatically—increasing eightfold from 5% in 1960 to 41% in 2008.This trend has contributed to the decrease in the share of children under age 18 living with two married parents – to 64% in 2008 from 87% in 1960.4

There are distinctive socio-economic, generational and racial patterns in the trends away from marriage and toward single parenthood and other emerging family forms.

Marriage rates are now more strongly linked to education than they have been in the past, with college graduates (64%) much more likely to be married than those who have never attended college (48%).

The racial differences are even larger. Blacks (32%) are much less likely than whites (56%) to be married, and this gap has increased significantly over time. And black children (52%) are nearly three times as likely as white children (18%) and nearly twice as likely as Hispanic children (27%) to live with one parent.

As the country shifts away from marriage, a smaller proportion of adults are experiencing the economic gains that typically accrue from marriage. In 2008, the median household income of married adults was 41% greater than that of unmarried adults, even after controlling for differences in household size.5 In 1960, this gap was only 12%. The widening of the gap is explained partly by the increased share of wives in the workforce (61% in 2008 versus 32% in 1960) and partly by the increased differential in the educational attainment of the married and the unmarried.6

The net result is that a marriage gap and a socio-economic gap have been growing side by side for the past half century, and each may be feeding off the other. As will be shown in greater detail in Chapter 2, adults on the lower rungs of the socio-economic ladder (whether measured by income or education) are just as eager as other adults to marry. But they place a higher premium on economic security as a prerequisite for marriage than do those with higher levels of income and education. And this is a bar that they—and their pool of prospective spouses—may find increasingly difficult to meet, given the fact that, relative to other groups, they have experienced significant economic declines in recent decades.

The changes in marriage rates are driven in large part by the behavior and attitudes of young adults, who are both delaying marriage and entering into less-traditional family arrangements. In 1960, 68% of adults ages 20-29 were married. By 2008, only 26% were married. The fact that young adults are delaying marriage does not necessarily mean they will never marry. Only time will tell. Meantime, it’s still the case that the vast majority of adults in the U.S. eventually get married. Among those ages 45 and older roughly nine-in-ten have ever married.

That said, young adults do have much different attitudes toward the trends that are driving family change. Nearly half of those under age 30 (46%) say the growing variety of family arrangements is a good thing, compared with just 30% of those ages 30 and older. In addition, young adults are much more accepting than their older counterparts of a host of societal trends affecting families, from more people living together without getting married to more gay and lesbian couples raising children.

Public Reactions to Decades of Change

The public is aware of the changes in marriage and family that have taken place over the past 50 years—and accepts some more readily than others. There is no clear consensus on the overall merit of the rise of new family arrangements. When asked whether the growing variety in the types of family arrangements is a good thing, a bad thing or doesn’t make a difference, the public is evenly split. A third (34%) say it’s a good thing, 29% say it’s a bad thing and 32% say it doesn’t make a difference.

Where you stand on this issue depends to some degree on how you live. Adults who are living a more traditional family life—married with children—are among the most resistant to the growing variety of family arrangements: 38% say it is a bad thing. Those who are divorced or separated have more of a live and let live attitude: a 39% plurality say the changes don’t make a difference. Those who are living with a partner are largely supportive of the new arrangements: a 56% majority says the growing variety is a good thing.

Of all the changes in family structure, the one that draws the strongest negative reaction is single parenthood. An overwhelming majority (69%) say the trend toward more single women having children without a male partner to help raise them is a bad thing for society. And a majority (61%) still believe that a child needs both a mother and a father to grow up happily.

Other changes get a much better reception from the public. For example, more than six-in-ten (62%) now say that the best kind of marriage is one where the husband and wife both work and both take care of the household and children. In 1977, fewer than half (48%) endorsed this egalitarian template for spousal roles.

And the public is quite open to the idea that marriage need not be the only path to family formation. An overwhelming majority says a single parent and a child constitute a family (86%), nearly as many (80%) say an unmarried couple living together with a child is a family, and 63% say a gay couple raising a child is a family.

Advanced Web Machinery

Advanced Web Machinery

Hello there, we are Dávid Csákvári and Tamás Sallai!

Dodie’s image Sashee’s image We are tech-savvy developers mainly on the web-dev field. We both hold a Master’s Degree in Computer Sciences and have more than half decade of field experience. We always seek new processes and technology to make better software. This blog is about the industry insight and problem solving experiences we encounter on a daily basis.

Better TeX math typesetting in Hugo

Better TeX math typesetting in Hugo

There is a page in the Hugo documentation that describes how to use MathJax to embed nicely-typeset mathematics in one’s Hugo-generated site.

For my own site, I took this as a starting point and made a few improvements. Here’s how I do the math typesetting in this blog.


I author my posts in Markdown, where the bulk of the content is plain text. When I want to include specially-typeset mathematical expressions, I use a custom shortcode to convert TeX-style equation definition into a snippet of HTML that looks nice when rendered in the browser.

So when I author a post, I’ll write something like this:

Here’s sum inline math: {{}}.

Display mode math looks like
Hugo will process this, apply my shortcode, and generate HTML that ultimately renders like this:

Here’s sum inline math: \sum_{n=1}^{\infty} 2^{-n} = 1∑
​​ 2
​​ =1 .

Display mode math looks like
\int \frac{1}{x} dx = \ln |x|∫

​​ dx=ln∣x∣
Shortcode and supporting markup

Here’s the definition of the shortcode:

<!– Hugo TeX shortcode
inline eqn: {{}}
display mode eqn: {{}}

{{ if .IsNamedParams }}
$${{ .Get “display” }}$$
{{ else }}
\({{ .Get 0 }}\)
{{ end }}

{{ if .IsNamedParams }}

{{ else }}

{{ end }}

This takes care of inserting the required content and tags for each particular expression, but that alone isn’t enough. Some additional Javascript and CSS are required in the header and footer of the page, as well.

In my Hugo page template I conditionally include this extra markup, which will pull down the CSS and Javascript libraries that do the real typesetting work when someone loads the page:

{{ if .GetParam “hasMath”}}
{{ end }}

{{ if .GetParam “hasMath”}}
{{ end }}
I simply add hasMath: true to the front matter of any post that has equations, and everything is taken care of. If a post doesn’t contain any mathematics, no superfluous scripts or CSS are included.

As you can see above, I am using KaTeX, a MathJax competitor from Khan Academy, as my backend typesetting library. KaTeX renders noticeably faster than MathJax, but has a more limited feature set. Given the meager sophistication of the equations appearing in this blog, I don’t need the more exotic features anyway, so KaTeX a pretty clear win.

Handling noscript

I’ve also taken care to include a block for each equation, which will activate when Javascript is disabled.

In such a case, KaTeX or MathJax won’t work, so I fall back to using flat images. Images don’t render as crisply, and won’t resize or zoom quite as well as proper HTML + CSS, but they will do in a pinch.

There are a few free cloud services available for this, which dynamically generate math typesetting images. You just embed the equation you want in the URL query parameters, and the server will create the image on the fly.

Google Charts is one such service. I’m currently using CodeCogs, as I find that its images look better than Google’s, and they support both inline and display-mode image rendering.

With Javascript disabled, the earlier example will render like this:

Here’s sum inline math: \sum_{n=1}^{\infty} 2^{-n} = 1.

Display mode math looks like

\int \frac{1}{x} dx = \ln |x|
To prevent the Javascript-only equation markup from appearing “raw” next to the images, I include a small bit of CSS in every page to hide such elements:

.jsonly { display: none }

RSS readers

Some people consume my blog through an RSS reader, rather than visiting my site directly. It would be nice if equations came through in a reasonable way for for these people, too.

Javascript is not exposed to RSS at all, so KaTeX and MathJax are out the window, and I am limited to HTML and inline CSS for formatting. Thankfully, this is exactly how the noscript fallback operates, so most of the work is already done.

After running Hugo to generate all of my site’s HTML and RSS content, I run a post-processing script to fix up the RSS XML slightly. The script does 2 things:

Removes the jsonly spans entirely, since they aren’t useful for RSS and will be rendered in their ugly raw form.
Removes the noscript opening and closing tags, leaving just the inner image content. Some RSS readers will not render content inside of noscript tags, so it’s important to remove these.
Here’s a snippet of PowerShell that does the trick:

$content = [io.file]::ReadAllText(‘index.xml’)

# delete jsonly spans completely
$content = $content -replace ‘<span class="jsonly">\s*.+?\s*</span>’,”

# remove tags, leaving just the inner content
$content = $content -replace ‘<noscript>\s*((?:.|\s)+?)\s*</noscript>’, ‘$1’

[io.file]::WriteAllText(‘index.xml’, $content)
What’s left should look fairly decent in most RSS readers.

Press and Articles

Press and Articles

Title Author Date
Hugo Easy Gallery – Automagical PhotoSwipe image gallery with a one-line shortcode Li-Wen Yip 2017-03-25
Automagical Image Gallery in Hugo with PhotoSwipe and jQuery Li-Wen Yip 2017-03-04
Adding Isso Comments to Hugo Stíobhart Matulevicz 2017-02-24
Hugo Tutorial: How to Build & Host a (Very Fast) Static E-Commerce Site Snipcart 2017-02-23
How to Password Protect a Hugo Site Aerobatic 2017-02-19
Switching from WordPress to Hugo Mario Martelli 2017-02-19
Zero to HTTP/2 with AWS and Hugo Josh Habdas 2017-02-16
Deploy a Hugo site to Aerobatic with CircleCI Aerobatic 2017-02-14
NPM scripts for building and deploying Hugo site Aerobatic 2017-02-12
Getting started with Hugo and the plain-blog theme, on NearlyFreeSpeech.Net Li-aung “Lewis” Yip 2017-02-12
Choose Hugo over Jekyll Josh Habdas 2017-02-10
Build a Hugo site using Cloud9 IDE and host on App Engine Pascal Aubort 2017-02-05
Hugo Continuous Deployment with Bitbucket Pipelines and Aerobatic Aerobatic 2017-02-04
How to use Firebase to host a Hugo site Andrew Cuga 2017-02-04
A publishing workflow for teams using static site generators Tom Atkins 2017-01-02
How To Dynamically Use Google Fonts In A Hugo Website Hash Borgir 2016-10-27
Embedding Facebook In A Hugo Template Hash Borgir 2016-10-22
通过 Gitlab-cl 将 Hugo blog 自动部署至 GitHub (Chinese, Continious integration) Zetao Yang 2016-10-17
A Step-by-Step Guide: Hugo on Netlify Eli Williamson 2016-09-21
Building our site: From Django & WordPress to a static generator (Part I) Alan Descoins 2016-09-20
Webseitenmaschine – Statische Websites mit Hugo erzeugen (German, $) Christian Helmbold 2016-05-27
Cómo hacer sitios web estáticos con Hugo y Go – Platzi (Video tutorial) Verónica López 2016-04-06
CDNOverview: A CDN comparison site made with Hugo Thijs de Zoete 2016-02-23
Hugo: A Modern WebSite Engine That Just Works Shekhar Gulati 2016-02-14
Minify Hugo Generated HTML Ratson 2016-02-02
HugoのデプロイをWerckerからCircle CIに変更した – log Deprode 2016-01-17
Static site generators: el futuro de las webs estáticas
(Hugo, Jekyll, Flask y otros) Eneko Sarasola 2016-01-09
Writing a Lambda Function for Hugo Jeremy Olexa 2016-01-01
Ein Blog mit Hugo erstellen – Tutorial (Deutsch/German) Bernhard Albicker 2015-12-30
How to host Hugo static website generator on AWS Lambda Ilya Bezdelev 2015-12-15
Migrating from Pelican to Hugo Salar Rahmanian 2015-11-29
Static Website Generators Reviewed: Jekyll, Middleman, Roots, Hugo Mathias Biilmann Christensen 2015-11-16
How To Deploy a Hugo Site to Production with Git Hooks on Ubuntu 14.04 Justin Ellingwood 2015-11-12
How To Install and Use Hugo, a Static Site Generator, on Ubuntu 14.04 Justin Ellingwood 2015-11-09
Switching from WordPress to Hugo Justin Israel 2015-11-08
Hands-on Experience with Hugo as a Static Site Generator Thomas Peham 2015-10-15
Statische Webseites mit Hugo erstellen/Vortrag mit Foliensatz (deutsch) Harald Weidner 2015-09-19
Moving from WordPress to Hugo Abhishek Pandey 2015-09-15
通过webhook将Hugo自动部署至GitHub Pages和GitCafe Pages (Automated deployment) CoderZh 2015-09-13
使用hugo搭建个人博客站点 (Using Hugo to build a personal blog site) CoderZh 2015-08-29
Good-Bye WordPress, Hello Hugo! (German) Armin Hanisch 2015-08-18
Générer votre site web statique avec Hugo (Generate your static site with Hugo) Benoît Benedetti 2015-06-26
Hugo向けの新しいテーマを作った (I created a new theme for Hugo) Daisuke Tsuji 2015-06-20
Hugo – Gerando um site com conteúdo estático. (Portuguese Brazil) Fabiano Frizzo 2015-06-02
An Introduction to Static Site Generators Eduardo Bouças 2015-05-20
Hugo Still Rules Cheeky Coder 2015-05-18
hugo – Static Site Generator G Scaccoio 2015-05-04
WindowsでHugoを使う うれ太郎 2015-05-01
Hugoのshortcodesを用いてサイトにスライドなどを埋め込む Yucchiy 2015-04-29
HugoとCircleCIでGitHub PagesにBlogを公開してみたら超簡単だった Hori Ryota 2015-04-17
10 Best Static Site Generators Aniruddha Mysore 2015-04-06
Goodbye WordPress; Hello Hugo Will Warren 2015-04-05
Static Websites with Hugo on Google Cloud Storage Moxie Input/Output 2015-04-02
De nuevo iniciando un blog Alvaro Lizama 2015-03-29
We moved our blog from Posthaven to Hugo after only three posts. Why? Hypriot 2015-03-27
Top Static Site Generators in 2015 Kanishk Kunal 2015-03-12
Moving to Hugo Abiola Ibrahim 2015-03-08
Migrating a blog (yes, this one!) from WordPress to Hugo Justin Dunham 2015-02-13
blogをoctopressからHugoに乗り換えたメモ jigyakkuma 2015-02-11
Hugoでブログをつくった porgy13 2015-02-07
Hugoにブログを移行した Keichi Takahashi 2015-02-04
Hugo静态网站生成器中文教程 Nanshu Wang 2015-01-31
Hugo + Github Pages + Wercker CI = ¥0(無料)
でコマンド 1 発(自動化)でサイト
・ブログを公開・運営・分析・収益化 Yohei Yoshimuta 2015-01-31
Running Hugo websites on anynines Julian Weber 2015-01-30
MiddlemanからHugoへ移行した Haruki Konishi 2015-01-21
WordPress から Hugo に乗り換えました rakuishi 2015-01-20
HUGOを使ってサイトを立ち上げる方法 Syui 2015-01-17
Jekyllが許されるのは小学生までだよね Ishimoto Koji 2015-01-16
Getting started with Hugo Anthony Fok 2015-01-12
把这个博客静态化了 (Migrate to Hugo) Li Cheng 2015-01-03
Porting my blog with Hugo Stuart Rackham 2014-12-30
Hugoを使ってみたときのメモ Machortz 2014-12-29
OctopressからHugoへ移行した Taichi Nakashima 2014-12-25
Migrating to Hugo From Octopress Nathan LeClaire 2014-12-22
Dynamic Pages with Cyrill Schumacher 2014-12-21
6 Static Blog Generators That Aren’t Jekyll David Turnbull 2014-12-08
Travel Blogging Setup Rasmus Stougaard 2014-11-23
Hosting A Hugo Website Behind Nginx Rick Beton 2014-11-20
使用Hugo搭建免费个人Blog (How to use Hugo) Ulric Qin 秦晓辉 2014-11-11
Built in Speed and Built for Speed by Hugo Cheeky Coder 2014-10-30
Hugo para crear sitios web estáticos Web Bizarro 2014-08-19
Going with hugo Markus Eliasson 2014-08-18
Benchmarking Jekyll, Hugo and Wintersmith Fredrik Loch 2014-08-12
Goodbye Octopress, Hello Hugo! Andrei Mihu 2014-08-11
Beautiful sites for Open Source projects Beautiful Open 2014-08-09
Hugo: Beyond the Defaults Nate Finch 2014-08-08
First Impressions of Hugo Peter Aba 2014-06-06
New Site Workflow Giles Paterson 2014-08-05
How I Learned to Stop Worrying and Love the (Static) Web Joshua McKenty 2014-08-04
Hugo – Static Site Generator Kenny Woo 2014-08-03
Hugo Is Friggin’ Awesome Nate Finch 2014-08-01
再次搬家 (Move from WordPress to Hugo) 青砾 (chingli) 2014-07-12
Embedding Gists in Hugo Dan Mull 2014-07-05
An Introduction To Hugo Dan Silber 2014-07-01
Moving to Hugo Dan Mull 2014-05-29
(Leaderboard of open-source static website generators) 2014-05-23
Finally, a satisfying and effective blog setup Michael Whatcott 2014-05-20
Hugo from scratch Zack Williams 2014-05-18
Why I switched away from Jekyll Jake Januzelli 2014-05-10
Welcome our new blog 2014-04-11
Mission Not Accomplished Dave Johnston 2014-04-03
Hugo – A Static Site Builder in Go Deep Fried Code 2014-03-30
Adventures in Angular Podcast Matias Niemela 2014-03-28
Hugo 2014-03-23
Converting Blogger To Markdown Trisha Gee 2014-03-20
Moving to Hugo Static Web Pages Tobias Weingartner 2014-03-16
New Blog Engine: Hugo fREW Schmidt 2014-03-15
Hugo + gulp.js = Huggle Jesse Yang 杨建超 2014-03-08
Powered by Hugo Kieran Healy 2014-02-24
Shogo Hamada
Latest Roundup of Useful Tools For Developers CodeGeekz 2014-02-13
Hugo: Static Site Generator written in Go Brave Terry 2014-02-06
10 Useful HTML5 Tools for Web Designers and Developers Design Dizzy 2014-02-04
Hugo – Fast, Flexible Static Site Generator Joby Joseph 2014-01-18
Hugo: A new way to build static website w3update 2014-01-17
Xaprb now uses Hugo Baron Schwartz 2014-01-15
New jQuery Plugins And Resources That Web Designers Need Design Your Way 2014-01-01
On Blog Construction Alexander Lash 2013-12-27
Hugo One Thing Well 2013-12-05
In Praise Of Hugo 2013-10-19
Hosting a blog on S3 and Cloudfront Dan Esparza 2013-07-24

a great toolset for static blogging

a great toolset for static blogging

I’ve considered switching from Jekyll to some other static blogging solution for quite a while. My main motivator was that I disliked to touch Ruby tooling for this purpose and other minor details regarding speed of previewing as the site grows, etc.

So, once I came to know of Hugo, I got interesting in it. It’s just a simple binary!, readily available from AUR (I’m an ArchLinux user), built upon Go.

And after reading some comparisons I got hooked.

At the time I learned about Hugo I didn’t have enough incentive to switch, since I had my blog on GitHub Pages just by posting Markdown files there without having to post a build of the site (leveraging GitHub’s native Jekyll support). I had to build the blog just for local previewing, hence I wished to avoid this getting slower over time. I also wished instant previewing too, just like Hugo offers.

Enter GitLab Pages, which allows you to choose your blogging engine! Once I’ve seen this from GitLab on my tweet stream I thought it was time for another try.

GitLab Pages supports Hugo hosting (and many others) just like GitHub supports Jekyll, they support custom domains and it’s really simple to setup. This blog sources are hosted at

There was just one additional caveat with moving to Hugo, I needed to make sure that Markdown parsing options would be good enough to embed math. Jekyll supports Kramdown, which is a Markdown superset that’s friendly to MathJax and the like. Many other parsers have issues with Markdown containing LaTeX content.

Hugo has a tutorial about setting up MathJax, but there’s a much easier route than what’s described there. Being technical, I checked exactly what parsers does Hugo supports and learned that it supports a Markdown superset known as Mmark.

Mmark is a great Markdown dialect which I started to adopt, it works with Hugo out of the box, you just need to name your files *.mmark. It’s MathJax friendly and Pandoc syntax works OK for it in Vim.

As a last improvement, I’ve took opportunity to also switch from MathJax to KaTeXKaTeX. It was very simple to setup my Hugo theme for it, which allows me to write stuff like the following using simple LaTeX:

R_{\mu\nu} – \frac{1}{2}g_{\mu\nu}R = \frac{8\pi G}{c^4}T_{\mu\nu}R
​​ −

​​ g
​​ R=

​​ T

And it should cost much less for rendering. With KaTeXKaTeX there’s even the option to have more localized DOM scanning, but for now I’ve just enabled it globally. It’s faster, but it’s not as exact at rendering as MathJax, and also support less LaTeX as it’s more equation focused.