Merge branch 'main' into main
29
README.md
|
@ -22,6 +22,7 @@ Blowfish is designed to be a powerful, lightweight theme for [Hugo](https://gohu
|
|||
- Views count & like mechanism
|
||||
- Multiple homepage layouts
|
||||
- Support for multiple authors
|
||||
- Support for series of articles
|
||||
- Flexible with any content types, taxonomies and menus
|
||||
- Multilingual content support inlcuding support for RTL languages
|
||||
- Ability to link to posts on third-party websites
|
||||
|
@ -50,9 +51,31 @@ Blowfish has [extensive documentation](https://nunocoracao.github.io/blowfish/do
|
|||
|
||||
## Installation
|
||||
|
||||
Blowfish supports several installation methods - as a Hugo Module (easiest), a git submodule, or as a completely manual install.
|
||||
Blowfish supports several installation methods - as a git submodule, a Hugo Module, or as a completely manual install.
|
||||
|
||||
Detailed instructions for each method can be found in the [Installation](https://nunocoracao.github.io/blowfish/docs/installation) docs. You should consult the documentation for the simplest setup experience. Below is a quick start guide using Hugo modules if you're already confident installing Hugo themes.
|
||||
Detailed instructions for each method can be found in the [Installation](https://nunocoracao.github.io/blowfish/docs/installation) docs. You should consult the documentation for the simplest setup experience. Below is a quick start guide using submodules if you are using git, or Hugo modules if you're already confident installing Hugo themes.
|
||||
|
||||
### Quick start using git submodules
|
||||
|
||||
> **Note:** Ensure you have **Git**, **Go**, and **Hugo** installed, and that you have created a new Hugo project before proceeding.
|
||||
|
||||
1. From your project directory, initialise git:
|
||||
|
||||
```shell
|
||||
git init
|
||||
```
|
||||
|
||||
2. Configure Blowfish as a git submodule:
|
||||
|
||||
```shell
|
||||
git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish
|
||||
```
|
||||
|
||||
3. In the root folder of your website, delete the `config.toml` file that was generated by Hugo. Copy the `*.toml` config files from the theme into your `config/_default/` folder.
|
||||
|
||||
You will find these theme config files in the Hugo cache directory, or [download a copy](https://minhaskamal.github.io/DownGit/#/home?url=https://github.com/nunocoracao/blowfish/tree/main/config/_default) from GitHub.
|
||||
|
||||
4. Follow the [Getting Started](https://nunocoracao.github.io/blowfish/docs/getting-started/) instructions to configure your website.
|
||||
|
||||
### Quick start using Hugo
|
||||
|
||||
|
@ -68,7 +91,7 @@ Detailed instructions for each method can be found in the [Installation](https:/
|
|||
|
||||
```toml
|
||||
[[imports]]
|
||||
path = "github.com/nunocoracao/blowfish"
|
||||
path = "github.com/nunocoracao/blowfish/v2"
|
||||
```
|
||||
|
||||
3. Start your server using `hugo server` and the theme will be downloaded automatically.
|
||||
|
|
|
@ -1570,6 +1570,14 @@ select {
|
|||
margin-left: 0.5rem;
|
||||
}
|
||||
|
||||
.mt-2 {
|
||||
margin-top: 0.5rem;
|
||||
}
|
||||
|
||||
.mb-5 {
|
||||
margin-bottom: 1.25rem;
|
||||
}
|
||||
|
||||
.\!mb-9 {
|
||||
margin-bottom: 2.25rem !important;
|
||||
}
|
||||
|
@ -1634,8 +1642,8 @@ select {
|
|||
height: 2rem;
|
||||
}
|
||||
|
||||
.h-\[45vh\] {
|
||||
height: 45vh;
|
||||
.h-\[300px\] {
|
||||
height: 300px;
|
||||
}
|
||||
|
||||
.h-36 {
|
||||
|
@ -1662,14 +1670,14 @@ select {
|
|||
width: 3rem;
|
||||
}
|
||||
|
||||
.w-36 {
|
||||
width: 9rem;
|
||||
}
|
||||
|
||||
.w-full {
|
||||
width: 100%;
|
||||
}
|
||||
|
||||
.w-36 {
|
||||
width: 9rem;
|
||||
}
|
||||
|
||||
.w-24 {
|
||||
width: 6rem;
|
||||
}
|
||||
|
@ -3065,10 +3073,6 @@ body:has(#menu-controller:checked) {
|
|||
}
|
||||
}
|
||||
|
||||
.max-w-prose {
|
||||
max-width: 75ch;
|
||||
}
|
||||
|
||||
.first\:mt-8:first-child {
|
||||
margin-top: 2rem;
|
||||
}
|
||||
|
@ -3382,16 +3386,16 @@ body:has(#menu-controller:checked) {
|
|||
background-color: rgba(var(--color-neutral-700), var(--tw-bg-opacity));
|
||||
}
|
||||
|
||||
.dark .dark\:bg-primary-900 {
|
||||
--tw-bg-opacity: 1;
|
||||
background-color: rgba(var(--color-primary-900), var(--tw-bg-opacity));
|
||||
}
|
||||
|
||||
.dark .dark\:bg-primary-800 {
|
||||
--tw-bg-opacity: 1;
|
||||
background-color: rgba(var(--color-primary-800), var(--tw-bg-opacity));
|
||||
}
|
||||
|
||||
.dark .dark\:bg-primary-900 {
|
||||
--tw-bg-opacity: 1;
|
||||
background-color: rgba(var(--color-primary-900), var(--tw-bg-opacity));
|
||||
}
|
||||
|
||||
.dark .dark\:from-neutral-800 {
|
||||
--tw-gradient-from: rgba(var(--color-neutral-800), 1);
|
||||
--tw-gradient-to: rgba(var(--color-neutral-800), 0);
|
||||
|
@ -3515,6 +3519,10 @@ body:has(#menu-controller:checked) {
|
|||
width: 50%;
|
||||
}
|
||||
|
||||
.sm\:max-w-prose {
|
||||
max-width: 65ch;
|
||||
}
|
||||
|
||||
.sm\:flex-row {
|
||||
flex-direction: row;
|
||||
}
|
||||
|
@ -3668,6 +3676,10 @@ body:has(#menu-controller:checked) {
|
|||
margin-right: 0px;
|
||||
}
|
||||
|
||||
.lg\:ml-auto {
|
||||
margin-left: auto;
|
||||
}
|
||||
|
||||
.lg\:mt-0 {
|
||||
margin-top: 0px;
|
||||
}
|
||||
|
|
|
@ -395,8 +395,4 @@ body:has(#menu-controller:checked) {
|
|||
.article {
|
||||
flex-wrap: nowrap;
|
||||
}
|
||||
}
|
||||
|
||||
.max-w-prose {
|
||||
max-width: 75ch;
|
||||
}
|
2
assets/icons/eye.svg
Normal file
|
@ -0,0 +1,2 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 576 512">
|
||||
<path fill="currentColor" d="M288 32c-80.8 0-145.5 36.8-192.6 80.6C48.6 156 17.3 208 2.5 243.7c-3.3 7.9-3.3 16.7 0 24.6C17.3 304 48.6 356 95.4 399.4C142.5 443.2 207.2 480 288 480s145.5-36.8 192.6-80.6c46.8-43.5 78.1-95.4 93-131.1c3.3-7.9 3.3-16.7 0-24.6c-14.9-35.7-46.2-87.7-93-131.1C433.5 68.8 368.8 32 288 32zM432 256c0 79.5-64.5 144-144 144s-144-64.5-144-144s64.5-144 144-144s144 64.5 144 144zM288 192c0 35.3-28.7 64-64 64c-11.5 0-22.3-3-31.6-8.4c-.2 2.8-.4 5.5-.4 8.4c0 53 43 96 96 96s96-43 96-96s-43-96-96-96c-2.8 0-5.6 .1-8.4 .4c5.3 9.3 8.4 20.1 8.4 31.6z"/></svg>
|
After Width: | Height: | Size: 633 B |
|
@ -12,7 +12,7 @@ if (typeof auth !== 'undefined') {
|
|||
var data = doc.data();
|
||||
if (data) {
|
||||
var label = document.querySelectorAll("span[id='" + oid + "']")[0].innerText.split(' ')[1]
|
||||
document.querySelectorAll("span[id='" + oid + "']")[0].innerText = numberWithCommas(data.views) + " " + label
|
||||
document.querySelectorAll("span[id='" + oid + "']")[0].innerText = numberWithCommas(data.views)
|
||||
}
|
||||
})
|
||||
}
|
||||
|
@ -22,7 +22,7 @@ if (typeof auth !== 'undefined') {
|
|||
var data = doc.data();
|
||||
if (data) {
|
||||
var label = document.querySelectorAll("span[id='" + oid + "']")[0].innerText.split(' ')[1]
|
||||
document.querySelectorAll("span[id='" + oid + "']")[0].innerText = numberWithCommas(data.likes) + " " + label
|
||||
document.querySelectorAll("span[id='" + oid + "']")[0].innerText = numberWithCommas(data.likes)
|
||||
}
|
||||
})
|
||||
}
|
||||
|
|
2
assets/lib/mermaid/mermaid.min.js
vendored
|
@ -2,6 +2,7 @@
|
|||
# Refer to the theme docs for more details about each of these parameters.
|
||||
# https://nunocoracao.github.io/blowfish/docs/getting-started/
|
||||
|
||||
# theme = "blowfish"
|
||||
# baseURL = "https://your_domain.com/"
|
||||
defaultContentLanguage = "en"
|
||||
|
||||
|
@ -18,6 +19,7 @@ buildFuture = false
|
|||
tag = "tags"
|
||||
category = "categories"
|
||||
author = "authors"
|
||||
series = "series"
|
||||
|
||||
[sitemap]
|
||||
changefreq = 'daily'
|
||||
|
|
|
@ -10,20 +10,20 @@
|
|||
# overridden by providing a weight value. The menu will then be
|
||||
# ordered by weight from lowest to highest.
|
||||
|
||||
[[main]]
|
||||
name = "Blog"
|
||||
pageRef = "posts"
|
||||
weight = 10
|
||||
#[[main]]
|
||||
# name = "Blog"
|
||||
# pageRef = "posts"
|
||||
# weight = 10
|
||||
|
||||
[[main]]
|
||||
name = "Categories"
|
||||
pageRef = "categories"
|
||||
weight = 20
|
||||
#[[main]]
|
||||
# name = "Categories"
|
||||
# pageRef = "categories"
|
||||
# weight = 20
|
||||
|
||||
[[main]]
|
||||
name = "Tags"
|
||||
pageRef = "tags"
|
||||
weight = 30
|
||||
#[[main]]
|
||||
# name = "Tags"
|
||||
# pageRef = "tags"
|
||||
# weight = 30
|
||||
|
||||
|
||||
# -- Footer Menu --
|
||||
|
@ -31,12 +31,12 @@
|
|||
# the copyright notice. Configure as per the main menu above.
|
||||
|
||||
|
||||
[[footer]]
|
||||
name = "Tags"
|
||||
pageRef = "tags"
|
||||
weight = 10
|
||||
# [[footer]]
|
||||
# name = "Tags"
|
||||
# pageRef = "tags"
|
||||
# weight = 10
|
||||
|
||||
[[footer]]
|
||||
name = "Categories"
|
||||
pageRef = "categories"
|
||||
weight = 20
|
||||
# [[footer]]
|
||||
# name = "Categories"
|
||||
# pageRef = "categories"
|
||||
# weight = 20
|
||||
|
|
|
@ -43,6 +43,7 @@ enableCodeCopy = true
|
|||
showEdit = true
|
||||
# editURL = "https://github.com/username/repo/"
|
||||
editAppendPath = true
|
||||
seriesOpened = false
|
||||
showHeadingAnchors = true
|
||||
showPagination = true
|
||||
invertPagination = false
|
||||
|
|
Before Width: | Height: | Size: 4.8 MiB After Width: | Height: | Size: 4.8 MiB |
|
@ -19,6 +19,7 @@ googleAnalytics = "G-PEDMYR1V0K"
|
|||
tag = "tags"
|
||||
category = "categories"
|
||||
author = "authors"
|
||||
series = "series"
|
||||
|
||||
[sitemap]
|
||||
changefreq = 'always'
|
||||
|
|
|
@ -23,7 +23,7 @@ mainSections = ["docs"]
|
|||
|
||||
[homepage]
|
||||
layout = "custom" # valid options: page, profile, hero, card, background, custom
|
||||
homepageImage = "iceland.jpg" # used in: hero, and card
|
||||
homepageImage = "/img/iceland.jpg" # used in: hero, and card
|
||||
showRecent = true
|
||||
showRecentItems = 5
|
||||
showMoreLink = true
|
||||
|
@ -42,6 +42,7 @@ mainSections = ["docs"]
|
|||
showEdit = true
|
||||
editURL = "https://github.com/nunocoracao/blowfish/tree/main/exampleSite/content"
|
||||
editAppendPath = true
|
||||
seriesOpened = false
|
||||
showHeadingAnchors = true
|
||||
showPagination = true
|
||||
invertPagination = false
|
||||
|
@ -56,7 +57,7 @@ mainSections = ["docs"]
|
|||
[list]
|
||||
showBreadcrumbs = false
|
||||
showSummary = true
|
||||
showTableOfContents = false
|
||||
showTableOfContents = true
|
||||
showCards = true
|
||||
groupByYear = false
|
||||
|
||||
|
|
|
@ -5,6 +5,8 @@ draft: false
|
|||
description: "Learn how to build Blowfish manually."
|
||||
slug: "advanced-customisation"
|
||||
tags: ["advanced", "css", "docs"]
|
||||
series: ["Documentation"]
|
||||
series_order: 13
|
||||
---
|
||||
|
||||
There are many ways you can make advanced changes to Blowfish. Read below to learn more about what can be customised and the best way of achieving your desired result.
|
||||
|
|
|
@ -5,6 +5,8 @@ draft: false
|
|||
description: "All the configuration variables available in Blowfish."
|
||||
slug: "configuration"
|
||||
tags: ["config", "docs"]
|
||||
series: ["Documentation"]
|
||||
series_order: 4
|
||||
---
|
||||
|
||||
Blowfish is a highly customisable theme and uses some of the latest Hugo features to simplify how it is configured.
|
||||
|
@ -68,9 +70,11 @@ The theme currently supports the following languages by default:
|
|||
| :jp: Japanese | `ja` |
|
||||
| :brazil: Portuguese (Brazil) | `pt-br` |
|
||||
| :portugal: Portuguese (Portugal) | `pt-pt` |
|
||||
| :poland: Polish | `pl` |
|
||||
| :romania: Romanian | `ro` |
|
||||
| :es: Spanish (Spain) | `es` |
|
||||
| :tr: Turkish | `tr` |
|
||||
| 🇭🇷 Croatian | `hr` |
|
||||
|
||||
The default translations can be overridden by creating a custom file in `i18n/[code].yaml` that contains the translation strings. You can also use this method to add new languages. If you'd like to share a new translation with the community, please [open a pull request](https://github.com/nunocoracao/blowfish/pulls).
|
||||
|
||||
|
@ -129,6 +133,7 @@ Many of the article defaults here can be overridden on a per article basis by sp
|
|||
|`logo`|_Not set_|The relative path to the site logo file within the `assets/` folder. The logo file should be provided at 2x resolution and supports any image dimensions.|
|
||||
|`mainSections`|_Not set_|The sections that should be displayed in the recent articles list. If not provided the section with the greatest number of articles is used.|
|
||||
|`robots`|_Not set_|String that indicates how robots should handle your site. If set, it will be output in the page head. Refer to [Google's docs](https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives) for valid values.|
|
||||
|`disableImageZoom`|`false`|Disables image zoom feature across all the images in the site.|
|
||||
|`footer.showMenu`|`true`|Show/hide the footer menu, which can be configured in the `[[footer]]` section of the `config/_default/menus.en.toml` file.|
|
||||
|`footer.showCopyright`|`true`|Whether or not to show the copyright string in the site footer. Note that the string itself can be customised using the `copyright` parameter in the [languages configuration](#language-and-i18n).|
|
||||
|`footer.showThemeAttribution`|`true`|Whether or not to show the "powered by" theme attribution in the site footer. If you choose to disable this message, please consider attributing the theme somewhere else on your site (for example, on your about page).|
|
||||
|
@ -152,6 +157,7 @@ Many of the article defaults here can be overridden on a per article basis by sp
|
|||
|`article.showEdit`|`false`|Whether or not the link to edit the article content should be displayed.|
|
||||
|`article.editURL`|_Not set_|When `article.showEdit` is active, the URL for the edit link.|
|
||||
|`article.editAppendPath`|`true`|When `article.showEdit` is active, whether or not the path to the current article should be appended to the URL set at `article.editURL`.|
|
||||
|`article.seriesOpened`|`false`|Whether or not the series module will be displayed open by default or not.|
|
||||
|`article.showHeadingAnchors`|`true`|Whether or not heading anchor links are displayed alongside headings within articles.|
|
||||
|`article.showPagination`|`true`|Whether or not the next/previous article links are displayed in the article footer.|
|
||||
|`article.invertPagination`|`false`|Whether or not to flip the direction of the next/previous article links.|
|
||||
|
@ -188,4 +194,4 @@ Many of the article defaults here can be overridden on a per article basis by sp
|
|||
|
||||
The theme also includes a `markup.toml` configuration file. This file contains some important parameters that ensure that Hugo is correctly configured to generate sites built with Blowfish.
|
||||
|
||||
Always ensure this file is present in the config directory and that the required values are set. Failure to do so may cause certain features to fucntion incorrectly and could result in unintended behaviour.
|
||||
Always ensure this file is present in the config directory and that the required values are set. Failure to do so may cause certain features to function incorrectly and could result in unintended behaviour.
|
||||
|
|
|
@ -5,6 +5,8 @@ draft: false
|
|||
description: "All the partials available in Blowfish."
|
||||
slug: "content-examples"
|
||||
tags: ["content", "example"]
|
||||
series: ["Documentation"]
|
||||
series_order: 12
|
||||
---
|
||||
|
||||
If you've been reading the documentation in order, you should now know about all the features and configurations available in Blowfish. This page is designed to pull everything together and offer some worked examples that you might like to use in your Hugo project.
|
||||
|
|
|
@ -5,6 +5,8 @@ draft: false
|
|||
description: "Learn how to integrate Firebase and get dynamic data for views and likes."
|
||||
slug: "firebase-views"
|
||||
tags: ["firebase", "views", likes]
|
||||
series: ["Documentation"]
|
||||
series_order: 15
|
||||
---
|
||||
|
||||
In order to be able to support dynamic data across your website we've added the support to integrate Firebase. This will allow you to use the views feature across lists and posts.
|
||||
|
|
|
@ -5,6 +5,8 @@ draft: false
|
|||
description: "All the front matter variables available in Blowfish."
|
||||
slug: "front-matter"
|
||||
tags: ["front matter", "config", "docs"]
|
||||
series: ["Documentation"]
|
||||
series_order: 7
|
||||
---
|
||||
|
||||
In addition to the [default Hugo front matter parameters](https://gohugo.io/content-management/front-matter/#front-matter-variables), Blowfish adds a number of additional options to customise the presentation of individual articles. All the available theme front matter parameters are listed below.
|
||||
|
@ -43,6 +45,9 @@ Front matter parameter default values are inherited from the theme's [base confi
|
|||
|`showSummary`|`list.showSummary`|Whether or not the article summary should be displayed on list pages.|
|
||||
|`showViews`|`article.showViews`|Whether or not the article views should be displayed in lists and detailed view. This requires a firebase integration. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish|
|
||||
|`showLikes`|`article.showLikes`|Whether or not the article likes should be displayed in lists and detailed view. This requires a firebase integration. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish|
|
||||
|`seriesOpened`|`article.seriesOpened`|Whether or not the series module will be displayed open by default or not.|
|
||||
|`series`|_Not set_|Array of series the article belongs to, we recommend using only one series per article.|
|
||||
|`series_order`|_Not set_|Number of the article within the series.|
|
||||
|`summary`|Auto generated using `summaryLength` (see [site configuration]({{< ref "configuration#site-configuration" >}}))|When `showSummary` is enabled, this is the Markdown string to be used as the summary for this article.|
|
||||
|`xml`|`true` unless excluded by `sitemap.excludedKinds`|Whether or not this article is included in the generated `/sitemap.xml` file.|
|
||||
<!-- prettier-ignore-end -->
|
||||
|
|
|
@ -5,6 +5,8 @@ draft: false
|
|||
description: "All the front matter variables available in Blowfish."
|
||||
slug: "getting-started"
|
||||
tags: ["installation", "docs"]
|
||||
series: ["Documentation"]
|
||||
series_order: 3
|
||||
---
|
||||
|
||||
{{< alert >}}
|
||||
|
|
|
@ -5,6 +5,8 @@ draft: false
|
|||
description: "Configuring the homepage layout in the Blowfish theme."
|
||||
slug: "homepage-layout"
|
||||
tags: ["homepage", "layouts", "docs"]
|
||||
series: ["Documentation"]
|
||||
series_order: 5
|
||||
---
|
||||
|
||||
Blowfish provides a fully flexible homepage layout. There are two main templates to choose from with additional settings to adjust the design. Alternatively, you can also provide your own template and have complete control over the homepage content.
|
||||
|
@ -21,7 +23,7 @@ The author information is provided in the languages configuration file. Refer to
|
|||
|
||||
Additionally, any Markdown content that is provided in the homepage content will be placed below the author profile. This allows extra flexibility for displaying a bio or other custom content using shortcodes.
|
||||
|
||||
To enable the profile layout, set `homepage.layout = "profile"` in the `params.toml` configuration file.
|
||||
To enable the Profile layout, set `homepage.layout = "profile"` in the `params.toml` configuration file.
|
||||
|
||||
## Page layout
|
||||
|
||||
|
@ -29,7 +31,7 @@ The page layout is simply a normal content page that displays your Markdown cont
|
|||
|
||||
<img class="thumbnailshadow" src="home-page.png"/>
|
||||
|
||||
To enable the page layout, set `homepage.layout = "page"` in the `params.toml` configuration file.
|
||||
To enable the Page layout, set `homepage.layout = "page"` in the `params.toml` configuration file.
|
||||
|
||||
## Hero layout
|
||||
|
||||
|
@ -37,7 +39,7 @@ The hero layout brings together ideas from the profile and card layouts. This on
|
|||
|
||||
<img class="thumbnailshadow" src="home-hero.png"/>
|
||||
|
||||
To enable the profile layout, set `homepage.layout = "profile"` and `homepage.homepageImage` in the `params.toml` configuration file.
|
||||
To enable the Hero layout, set `homepage.layout = "hero"` and `homepage.homepageImage` in the `params.toml` configuration file.
|
||||
|
||||
## Background layout
|
||||
|
||||
|
@ -45,7 +47,7 @@ The background layout is a more smooth version of the hero layout. As in the Her
|
|||
|
||||
<img class="thumbnailshadow" src="home-background.png"/>
|
||||
|
||||
To enable the profile layout, set `homepage.layout = "background"` and `homepage.homepageImage` in the `params.toml` configuration file.
|
||||
To enable the Background layout, set `homepage.layout = "background"` and `homepage.homepageImage` in the `params.toml` configuration file.
|
||||
|
||||
## Card layout
|
||||
|
||||
|
@ -53,14 +55,14 @@ The card layout is an extension of the page layout. It provides the same level o
|
|||
|
||||
<img class="thumbnailshadow" src="home-card.png"/>
|
||||
|
||||
To enable the profile layout, set `homepage.layout = "profile"` and `homepage.homepageImage` in the `params.toml` configuration file.
|
||||
To enable the Card layout, set `homepage.layout = "card"` and `homepage.homepageImage` in the `params.toml` configuration file.
|
||||
|
||||
|
||||
## Custom layout
|
||||
|
||||
If the built-in homepage layouts aren't sufficient for your needs, you have the option to provide your own custom layout. This allows you to have total control over the page content and essentially gives you a blank slate to work with.
|
||||
|
||||
To enable the custom layout, set `homepage.layout = "custom"` in the `params.toml` configuration file.
|
||||
To enable the Custom layout, set `homepage.layout = "custom"` in the `params.toml` configuration file.
|
||||
|
||||
With the configuration value set, create a new `custom.html` file and place it in `layouts/partials/home/custom.html`. Now whatever is in the `custom.html` file will be placed in the content area of the site homepage. You may use whatever HTML, Tailwind, or Hugo templating functions you wish to define your layout.
|
||||
|
||||
|
|
|
@ -5,6 +5,8 @@ draft: false
|
|||
description: "Learn how to deploy a Blowfish site."
|
||||
slug: "hosting-deployment"
|
||||
tags: ["hosting", "deployment", "docs", "github", "netlify", "render"]
|
||||
series: ["Documentation"]
|
||||
series_order: 14
|
||||
---
|
||||
|
||||
There are many ways to deploy your Hugo website built with Blowfish. The theme is designed to be flexible in almost any deployment scenario.
|
||||
|
|
|
@ -5,6 +5,8 @@ draft: false
|
|||
description: "How to install the Blowfish theme."
|
||||
slug: "installation"
|
||||
tags: ["installation", "docs"]
|
||||
series: ["Documentation"]
|
||||
series_order: 2
|
||||
---
|
||||
|
||||
Simply follow the standard Hugo [Quick Start](https://gohugo.io/getting-started/quick-start/) procedure to get up and running quickly.
|
||||
|
@ -35,15 +37,29 @@ Note that you can name the project directory whatever you choose, but the instru
|
|||
|
||||
There several different ways to install the Blowfish theme into your Hugo website. From easiest to most difficult to install and maintain, they are:
|
||||
|
||||
- [Hugo module](#install-using-hugo) (recommended)
|
||||
- [Git submodule](#install-using-git)
|
||||
- [Git submodule](#install-using-git) (recommended)
|
||||
- [Hugo module](#install-using-hugo)
|
||||
- [Manual file copy](#install-manually)
|
||||
|
||||
If you're unsure, choose the Hugo module method.
|
||||
If you're unsure, choose the Git submodule method.
|
||||
|
||||
#### Install using git
|
||||
|
||||
This method is the quickest and easiest for keeping the theme up-to-date. Besides **Hugo** and **Go**, you'll also need to ensure you have **Git** installed on your local machine.
|
||||
|
||||
Change into the directory for your Hugo website (that you created above), initialise a new `git` repository and add Blowfish as a submodule.
|
||||
|
||||
```bash
|
||||
cd mywebsite
|
||||
git init
|
||||
git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish
|
||||
```
|
||||
|
||||
Then continue to [set up the theme configuration files](#set-up-theme-configuration-files).
|
||||
|
||||
#### Install using Hugo
|
||||
|
||||
This method is the quickest and easiest for keeping the theme up-to-date. Hugo uses **Go** to initialise and manage modules so you need to ensure you have `go` installed before proceeding.
|
||||
For this method you'll use Hugo to manage your themes. Hugo uses **Go** to initialise and manage modules so you need to ensure you have `go` installed before proceeding.
|
||||
|
||||
1. [Download](https://golang.org/dl/) and install Go. You can check if it's already installed by using the command `go version`.
|
||||
|
||||
|
@ -65,26 +81,12 @@ This method is the quickest and easiest for keeping the theme up-to-date. Hugo u
|
|||
|
||||
```toml
|
||||
[[imports]]
|
||||
path = "github.com/nunocoracao/blowfish"
|
||||
path = "github.com/nunocoracao/blowfish/v2"
|
||||
```
|
||||
|
||||
4. Start your server using `hugo server` and the theme will be downloaded automatically.
|
||||
5. Continue to [set up the theme configuration files](#set-up-theme-configuration-files).
|
||||
|
||||
#### Install using git
|
||||
|
||||
For this method you'll need to ensure you have **Git** installed on your local machine.
|
||||
|
||||
Change into the directory for your Hugo website (that you created above), initialise a new `git` repository and add Blowfish as a submodule.
|
||||
|
||||
```bash
|
||||
cd mywebsite
|
||||
git init
|
||||
git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish
|
||||
```
|
||||
|
||||
Then continue to [set up the theme configuration files](#set-up-theme-configuration-files).
|
||||
|
||||
#### Install manually
|
||||
|
||||
1. Download the latest release of the theme source code.
|
||||
|
@ -134,10 +136,20 @@ From time to time there will be [new releases](https://github.com/nunocoracao/bl
|
|||
|
||||
How you go about this will depend on the installation method you chose when the theme was originally installed. Instructions for each method can be found below.
|
||||
|
||||
- [Hugo module](#update-using-hugo)
|
||||
- [Git submodule](#update-using-git)
|
||||
- [Hugo module](#update-using-hugo)
|
||||
- [Manual file copy](#update-manually)
|
||||
|
||||
### Update using git
|
||||
|
||||
Git submodules can be updated using the `git` command. Simply execute the following command and the latest version of the theme will be downloaded into your local repository:
|
||||
|
||||
```shell
|
||||
git submodule update --remote --merge
|
||||
```
|
||||
|
||||
Once the submodule has been updated, rebuild your site and check everything works as expected.
|
||||
|
||||
### Update using Hugo
|
||||
|
||||
Hugo makes updating modules super easy. Simply change into your project directory and execute the following command:
|
||||
|
@ -150,16 +162,6 @@ Hugo will automatically update any modules that are required for your project. I
|
|||
|
||||
Then simply rebuild your site and check everything works as expected.
|
||||
|
||||
### Update using git
|
||||
|
||||
Git submodules can be updated using the `git` command. Simply execute the following command and the latest version of the theme will be downloaded into your local repository:
|
||||
|
||||
```shell
|
||||
git submodule update --remote --merge
|
||||
```
|
||||
|
||||
Once the submodule has been updated, rebuild your site and check everything works as expected.
|
||||
|
||||
### Update manually
|
||||
|
||||
Updating Blowfish manually requires you to download the latest copy of the theme and replace the old version in your project.
|
||||
|
|
|
@ -5,6 +5,8 @@ draft: false
|
|||
description: "Configure multiple authors for your articles."
|
||||
slug: "multi-author"
|
||||
tags: ["authors", "config", "docs"]
|
||||
series: ["Documentation"]
|
||||
series_order: 10
|
||||
showAuthor: true
|
||||
authors:
|
||||
- "nunocoracao"
|
||||
|
|
|
@ -5,6 +5,8 @@ draft: false
|
|||
description: "All the partials available in Blowfish."
|
||||
slug: "partials"
|
||||
tags: ["partials", "analytics", "privacy", "comments", "favicons", "icon", "docs"]
|
||||
series: ["Documentation"]
|
||||
series_order: 9
|
||||
---
|
||||
|
||||
## Analytics
|
||||
|
|
BIN
exampleSite/content/docs/series/featured.png
Normal file
After Width: | Height: | Size: 1.7 MiB |
36
exampleSite/content/docs/series/index.md
Normal file
|
@ -0,0 +1,36 @@
|
|||
---
|
||||
title: "Series"
|
||||
date: 2020-08-09
|
||||
draft: false
|
||||
description: "Learn how to group articles under a series."
|
||||
slug: "series"
|
||||
tags: ["series", "docs"]
|
||||
series: ["Documentation"]
|
||||
series_order: 11
|
||||
seriesOpened: true
|
||||
---
|
||||
|
||||
Blowfish provides a feature to group a set of articles together under a "series". Placing an article under a series will display the rest of the series articles in each single page and provide a quick way to navigate amongst them. You can see an example of this above.
|
||||
|
||||
## Create Taxonomy
|
||||
The first step to enable series is to create the `series` taxonomy. For doing this just add the `series` taxonomy to your taxonomy list in the `config.toml`.
|
||||
|
||||
```toml
|
||||
[taxonomies]
|
||||
tag = "tags"
|
||||
category = "categories"
|
||||
author = "authors"
|
||||
series = "series"
|
||||
```
|
||||
|
||||
## Mark Articles
|
||||
|
||||
Then you just need to mark each article using the `series` parameter and the `series_order`. The `series` parameter will be the id and name of the series you are placing the article into (even though the variable is an array we recommend keeping each article to a single series.). And the `series_order` defines the order of that article within the series. In the example below the article is number `11` in the `Documentation` series.
|
||||
|
||||
```md
|
||||
series: ["Documentation"]
|
||||
series_order: 11
|
||||
```
|
||||
|
||||
## Series Behavior
|
||||
Marking an article as part of a series will automatically display the series module as you see in this page for example. You can choose whether that module starts opened or not using the `article.seriesOpened` global variable in `params.toml` or the front-matter parameter `seriesOpened` to specify an override at the article level.
|
|
@ -5,6 +5,8 @@ draft: false
|
|||
description: "All the shortcodes available in Blowfish."
|
||||
slug: "shortcodes"
|
||||
tags: ["shortcodes", "mermaid", "icon", "lead", "docs"]
|
||||
series: ["Documentation"]
|
||||
series_order: 8
|
||||
---
|
||||
|
||||
In addition to all the [default Hugo shortcodes](https://gohugo.io/content-management/shortcodes/), Blowfish adds a few extras for additional functionality.
|
||||
|
|
|
@ -5,6 +5,8 @@ draft: false
|
|||
description: "Turn on thumbnails for your articles."
|
||||
slug: "thumbnails"
|
||||
tags: ["thumbnail", "config", "docs"]
|
||||
series: ["Documentation"]
|
||||
series_order: 6
|
||||
---
|
||||
|
||||
## Thumbnails
|
||||
|
|
|
@ -4,6 +4,8 @@ date: 2022-01-19
|
|||
draft: false
|
||||
description: "Discover what's new in Blowfish version 2.0."
|
||||
tags: ["new", "docs"]
|
||||
series: ["Documentation"]
|
||||
series_order: 1
|
||||
---
|
||||
|
||||
{{< lead >}}
|
||||
|
|
|
@ -1,9 +1,11 @@
|
|||
---
|
||||
title: "An External Article"
|
||||
date: 2019-01-24
|
||||
externalUrl: "https://jamespanther.com/writings/i-switched-from-google-analytics-to-fathom-analytics/"
|
||||
externalUrl: "https://nunocoracao.com/projects/"
|
||||
summary: "The `externalUrl` front matter parameter can link to any URL."
|
||||
showReadingTime: false
|
||||
showReadingTime: true
|
||||
showLikes: false
|
||||
showViews: false
|
||||
_build:
|
||||
render: "false"
|
||||
list: "local"
|
||||
|
|
|
@ -35,6 +35,7 @@ The full list of built-in icons and their corresponding names can referenced bel
|
|||
| dribbble | {{< icon dribbble >}} |
|
||||
| edit | {{< icon edit >}} |
|
||||
| email | {{< icon email >}} |
|
||||
| eye | {{< icon eye >}} |
|
||||
| facebook | {{< icon facebook >}} |
|
||||
| fire | {{< icon fire >}} |
|
||||
| flickr | {{< icon flickr >}} |
|
||||
|
|
|
@ -11,9 +11,12 @@ KaTeX can be used to render mathematical notation within articles.
|
|||
|
||||
{{< katex >}}
|
||||
|
||||
Blowfish will only bundle the KaTeX assets into your project if you make use of mathematical notation. In order for this to work, simply include the [`katex` shortcode]({{< ref "docs/shortcodes#katex" >}}) within the article. Any KaTeX syntax on that page will then be automatically rendered.
|
||||
Blowfish will only bundle the KaTeX assets into your project if you make use of mathematical notation. In order for this to work, simply include the [`katex` shortcode]({{< ref "docs/shortcodes#katex" >}}) within the article. Example below:
|
||||
|
||||
Use the online reference of [supported TeX functions](https://katex.org/docs/supported.html) for the available syntax.
|
||||
```md
|
||||
{{</* katex */>}}
|
||||
```
|
||||
Any KaTeX syntax on that page will then be automatically rendered. Use the online reference of [supported TeX functions](https://katex.org/docs/supported.html) for the available syntax.
|
||||
|
||||
## Inline notation
|
||||
|
||||
|
|
|
@ -20,6 +20,7 @@ Real websites that are built with Blowfish.
|
|||
| Website | Details |
|
||||
| --------------------------------------------------------------------- | ---------------------------- |
|
||||
| [nunocoracao.com](https://nunocoracao.com) | Personal site - Theme author |
|
||||
| [madoke.org](https://madoke.org/) | Personal site |
|
||||
| [code-chimp.com](https://code-chimp.com) | Personal site |
|
||||
| [mucahitkurtlar.github.io](https://mucahitkurtlar.github.io) | Personal site |
|
||||
| [brendanwallace.github.io](https://brendanwallace.github.io) | Personal site |
|
||||
|
@ -38,7 +39,9 @@ Real websites that are built with Blowfish.
|
|||
| [blog.watchstep.me](https://blog.watchstep.me) | Personal site |
|
||||
| [overdevelop.io](https://overdevelop.io) | Personal site |
|
||||
| [loisvelasco.is-a.dev](https://loisvelasco.is-a.dev) | Personal site |
|
||||
|
||||
| [tabletopflore.com](https://www.tabletopflore.com) | Personal site |
|
||||
| [omarohn.de](https://omarohn.de) | Personal site |
|
||||
| [spelucin.me](https://spelucin.me) | Personal site |
|
||||
|
||||
{{< alert >}}
|
||||
|
||||
|
|
After Width: | Height: | Size: 926 KiB |
After Width: | Height: | Size: 671 KiB |
After Width: | Height: | Size: 1.9 MiB |
After Width: | Height: | Size: 613 KiB |
2
go.mod
|
@ -1,3 +1,3 @@
|
|||
module github.com/nunocoracao/blowfish
|
||||
module github.com/nunocoracao/blowfish/v2
|
||||
|
||||
go 1.16
|
||||
|
|
62
i18n/hr.yaml
Normal file
|
@ -0,0 +1,62 @@
|
|||
article:
|
||||
anchor_label: "Sidro"
|
||||
date: "{{ .Date }}"
|
||||
date_updated: "Ažurirano: {{ .Date }}"
|
||||
draft: "Nacrt"
|
||||
edit_title: "Uredi sadržaj"
|
||||
reading_time:
|
||||
one: "{{ .Count }} minut"
|
||||
other: "{{ .Count }} minuta"
|
||||
reading_time_title: "Vrijeme čitanja"
|
||||
table_of_contents: "Tablica sadržaja"
|
||||
word_count:
|
||||
one: "{{ .Count }} riječ"
|
||||
other: "{{ .Count }} riječi"
|
||||
views:
|
||||
one: "{{ .Count }} pregled"
|
||||
other: "{{ .Count }} pregleda"
|
||||
likes:
|
||||
one: "{{ .Count }} sviđa se"
|
||||
other: "{{ .Count }} sviđa se"
|
||||
|
||||
author:
|
||||
byline_title: "Autor"
|
||||
|
||||
code:
|
||||
copy: "Kopiraj"
|
||||
copied: "Kopirano"
|
||||
|
||||
error:
|
||||
404_title: "Stranica nije pronađena :confused:"
|
||||
404_error: "Greška 404"
|
||||
404_description: "Čini se da stranica koju ste zatražili ne postoji."
|
||||
|
||||
footer:
|
||||
dark_appearance: "Promjeni na tamni izgled"
|
||||
light_appearance: "Promijeni na svijetli izgled"
|
||||
powered_by: "Napravljeno pomoću {{ .Hugo }} & {{ .Theme }}"
|
||||
|
||||
list:
|
||||
externalurl_title: "Link to external site"
|
||||
no_articles: "Ovdje još nema članaka"
|
||||
|
||||
nav:
|
||||
scroll_to_top_title: "Otiđi na vrh"
|
||||
skip_to_main: "Otiđi na glavni sadržaj"
|
||||
|
||||
search:
|
||||
open_button_title: "Pretraga (/)"
|
||||
close_button_title: "Izađi (Esc)"
|
||||
input_placeholder: "Pretraži"
|
||||
|
||||
sharing:
|
||||
email: "Pošalji putem e-pošte"
|
||||
facebook: "Podijeli na Facebook"
|
||||
linkedin: "Podijeli na LinkedIn"
|
||||
pinterest: "Podijeli na Pinterest"
|
||||
reddit: "Objavi na Reddit"
|
||||
twitter: "Tweet na Twitter"
|
||||
|
||||
shortcode:
|
||||
recent_articles: "Nedavno"
|
||||
|
|
@ -1,3 +1,2 @@
|
|||
<a href="{{ .Destination | safeURL }}" {{ with .Title}} title="{{ . }}"{{ end }} {{ if or (strings.HasPrefix .Destination "http:") (strings.HasPrefix .Destination "https:") }} target="_blank"{{ end }}>
|
||||
{{ .Text | safeHTML }}
|
||||
</a>
|
||||
{{ .Text | safeHTML }}</a>
|
|
@ -25,7 +25,7 @@
|
|||
</div>
|
||||
</section>
|
||||
{{ if gt .Pages 0 }}
|
||||
<section class="space-y-10 max-w-prose">
|
||||
<section class="space-y-10 w-full">
|
||||
{{ range (.Paginate (.Pages.GroupByDate "2006")).PageGroups }}
|
||||
{{ if $.Params.groupByYear | default ($.Site.Params.list.groupByYear | default true) }}
|
||||
<h2 class="mt-12 text-2xl font-bold text-neutral-700 first:mt-8 dark:text-neutral-300">
|
||||
|
|
|
@ -2,11 +2,11 @@
|
|||
<article>
|
||||
{{ if .Params.showHero | default (.Site.Params.article.showHero | default false) }}
|
||||
{{ $heroStyle := print "partials/hero/" .Site.Params.article.heroStyle ".html" }}
|
||||
{{ if templates.Exists $heroStyle }}
|
||||
{{ partial $heroStyle . }}
|
||||
{{ else }}
|
||||
{{ partial "partials/hero/basic.html" . }}
|
||||
{{ end }}
|
||||
{{ if templates.Exists $heroStyle }}
|
||||
{{ partial $heroStyle . }}
|
||||
{{ else }}
|
||||
{{ partial "partials/hero/basic.html" . }}
|
||||
{{ end }}
|
||||
{{- end -}}
|
||||
<header id="single_header" class="mt-5 max-w-prose">
|
||||
{{ if .Params.showBreadcrumbs | default (.Site.Params.article.showBreadcrumbs | default false) }}
|
||||
|
@ -21,13 +21,15 @@
|
|||
</header>
|
||||
<section class="flex flex-col max-w-full mt-0 prose dark:prose-invert lg:flex-row">
|
||||
{{ if and (.Params.showTableOfContents | default (.Site.Params.article.showTableOfContents | default false)) (in
|
||||
.TableOfContents "<ul") }} <div class="order-first px-0 lg:order-last lg:max-w-xs ltr:lg:pl-8 rtl:lg:pr-8">
|
||||
.TableOfContents "<ul") }}
|
||||
<div class="order-first sm:max-w-prose lg:ml-auto px-0 lg:order-last lg:max-w-xs ltr:lg:pl-8 rtl:lg:pr-8">
|
||||
<div class="toc ltr:pl-5 rtl:pr-5 print:hidden lg:sticky lg:top-10">
|
||||
{{ partial "toc.html" . }}
|
||||
</div>
|
||||
</div>
|
||||
{{ end }}
|
||||
<div class="min-w-0 min-h-0 max-w-prose">
|
||||
{{ partial "series.html" . }}
|
||||
{{ .Content | emojify }}
|
||||
</div>
|
||||
<script>
|
||||
|
@ -146,10 +148,15 @@
|
|||
|
||||
var header = document.getElementById("single_header")
|
||||
var style = getComputedStyle(header);
|
||||
var margin = '-'+ (parseInt(style.height) + parseInt(style.marginTop) + parseInt(style.marginBottom) + 20) + 'px'
|
||||
var hero = document.getElementById('hero')
|
||||
if(hero)
|
||||
if (hero) {
|
||||
var margin = '-' + (parseInt(style.height) + parseInt(style.marginTop) + parseInt(style.marginBottom) + 20) + 'px'
|
||||
var height = (-parseInt(margin) + parseInt(getComputedStyle(hero).height)) + "px"
|
||||
console.log(height)
|
||||
hero.style["margin-bottom"] = margin;
|
||||
hero.style["height"] = height;
|
||||
}
|
||||
|
||||
</script>
|
||||
</section>
|
||||
<footer class="pt-8 max-w-prose print:hidden">
|
||||
|
@ -165,9 +172,9 @@
|
|||
|
||||
{{ $taxonomyLink := 0 }}
|
||||
{{ range $taxonomyname, $taxonomy := $taxonomies }}
|
||||
{{ if (eq $taxonomyname $author) }}
|
||||
{{ $taxonomyLink = delimit (slice $baseURL "authors/" $author) "" }}
|
||||
{{ end }}
|
||||
{{ if (eq $taxonomyname $author) }}
|
||||
{{ $taxonomyLink = delimit (slice $baseURL "authors/" $author) "" }}
|
||||
{{ end }}
|
||||
{{ end }}
|
||||
|
||||
{{ partial "author-extra.html" (dict "context" . "data" $authorData "link" $taxonomyLink) }}
|
||||
|
|
|
@ -12,7 +12,7 @@
|
|||
</div>
|
||||
</section>
|
||||
{{ end }}
|
||||
<section class="mt-5 space-y-10 max-w-prose">
|
||||
<section class="mt-5 space-y-10 w-full">
|
||||
{{ range (.Paginate (.Pages.GroupByDate "2006")).PageGroups }}
|
||||
{{ if $.Params.groupByYear | default ($.Site.Params.list.groupByYear | default true) }}
|
||||
<h2 class="mt-12 text-2xl font-bold text-neutral-700 first:mt-8 dark:text-neutral-300">
|
||||
|
|
|
@ -64,7 +64,7 @@
|
|||
{{ if .Params.showTaxonomies | default (.Site.Params.article.showTaxonomies | default false) }}
|
||||
<div class="flex flex-row flex-wrap items-center">
|
||||
{{ range $taxonomy, $terms := .Site.Taxonomies }}
|
||||
{{ if not (eq $taxonomy "authors")}}
|
||||
{{ if and (not (eq $taxonomy "authors")) (not (eq $taxonomy "series"))}}
|
||||
{{ if (gt (len ($context.GetTerms $taxonomy)) 0) }}
|
||||
{{ range $context.GetTerms $taxonomy }}
|
||||
<span style="margin-top:0.5rem" class="mr-2" onclick="window.open({{ .RelPermalink }});">
|
||||
|
|
|
@ -43,11 +43,13 @@
|
|||
|
||||
</div>
|
||||
<script>
|
||||
{{ if not .Site.Params.disableImageZoom | default true }}
|
||||
mediumZoom(document.querySelectorAll("img:not(.nozoom)"), {
|
||||
margin: 24,
|
||||
background: 'rgba(0,0,0,0.5)',
|
||||
scrollOffset: 0,
|
||||
})
|
||||
{{ end }}
|
||||
</script>
|
||||
{{ $jsProcess := resources.Get "js/process.js" }}
|
||||
{{ $jsProcess = $jsProcess | resources.Minify | resources.Fingerprint "sha512" }}
|
||||
|
|
|
@ -3,7 +3,7 @@
|
|||
{{- if not $featured }}{{ $featured = $images.GetMatch "{*cover*,*thumbnail*}" }}{{ end -}}
|
||||
{{- with $featured -}}
|
||||
{{ with .Resize "1200x" }}
|
||||
<div id="hero" class="relative h-[45vh] single_hero_background nozoom" style="background-image:url({{ .RelPermalink }});">
|
||||
<div id="hero" class="relative h-[300px] single_hero_background nozoom" style="background-image:url({{ .RelPermalink }});">
|
||||
<div class="hero_gradient bg-gradient-to-t from-neutral dark:from-neutral-800 to-transparent mix-blend-normal"></div>
|
||||
</div>
|
||||
{{ end }}
|
||||
|
|
|
@ -4,15 +4,20 @@
|
|||
<div class="mx-auto max-w-7xl p-0">
|
||||
<div class="relative sm:overflow-hidden">
|
||||
<div class="absolute inset-0">
|
||||
<img class="h-full w-full object-cover m-0 nozoom" src="{{ .Site.Params.homepage.homepageImage }}">
|
||||
{{ with .Site.Params.homepage.homepageImage }}
|
||||
{{ $homepageImage := resources.Get . }}
|
||||
{{ if $homepageImage }}
|
||||
<img class="h-full w-full object-cover m-0 nozoom" src="{{ $homepageImage.RelPermalink }}">
|
||||
<div
|
||||
class="absolute inset-0 bg-gradient-to-t from-neutral-100 dark:from-neutral-800 to-transparent dark:to-neutral-300 mix-blend-normal dark:mix-blend-multiply">
|
||||
</div>
|
||||
<div
|
||||
class="absolute inset-0 bg-gradient-to-t from-neutral dark:from-neutral-800 to-transparent mix-blend-normal">
|
||||
</div>
|
||||
{{ end }}
|
||||
{{ end }}
|
||||
</div>
|
||||
<div class="relative px-4 py-16 sm:px-6 sm:py-24 lg:py-32 lg:px-8 flex flex-col items-center">
|
||||
<div class="relative px-4 py-16 sm:px-6 sm:py-24 lg:py-32 lg:px-8 flex flex-col items-center justify-center text-center">
|
||||
{{ with .Site.Author.image }}
|
||||
{{ $authorImage := resources.Get . }}
|
||||
{{ if $authorImage }}
|
||||
|
|
|
@ -14,8 +14,13 @@
|
|||
</div>
|
||||
<div class="mt-6 sm:mt-16 lg:mt-0">
|
||||
<div class="-mr-48 pl-4 sm:pl-6 md:-mr-16 lg:relative lg:m-0 lg:h-full lg:px-0">
|
||||
{{ with .Site.Params.homepage.homepageImage }}
|
||||
{{ $homepageImage := resources.Get . }}
|
||||
{{ if $homepageImage }}
|
||||
<img class="w-full rounded-xl shadow-xl lg:absolute lg:left-0 lg:h-full lg:w-auto lg:max-w-none"
|
||||
src="{{ .Site.Params.homepage.homepageImage }}">
|
||||
src="{{ $homepageImage.RelPermalink }}">
|
||||
{{ end }}
|
||||
{{ end }}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
|
|
@ -4,12 +4,17 @@
|
|||
<div class="mx-auto max-w-7xl p-0">
|
||||
<div class="relative shadow-xl sm:overflow-hidden rounded-2xl">
|
||||
<div class="absolute inset-0">
|
||||
<img class="h-full w-full object-cover m-0 nozoom" src="{{ .Site.Params.homepage.homepageImage }}">
|
||||
{{ with .Site.Params.homepage.homepageImage }}
|
||||
{{ $homepageImage := resources.Get . }}
|
||||
{{ if $homepageImage }}
|
||||
<img class="h-full w-full object-cover m-0 nozoom" src="{{ $homepageImage.RelPermalink }}">
|
||||
<div
|
||||
class="absolute inset-0 bg-gradient-to-r from-primary-500 to-secondary-700 dark:from-primary-600 dark:to-secondary-800 mix-blend-multiply">
|
||||
</div>
|
||||
{{ end }}
|
||||
{{ end }}
|
||||
</div>
|
||||
<div class="relative px-4 py-16 sm:px-6 sm:py-24 lg:py-32 lg:px-8 flex flex-col items-center">
|
||||
<div class="relative px-4 py-16 sm:px-6 sm:py-24 lg:py-32 lg:px-8 flex flex-col items-center justify-center text-center">
|
||||
{{ with .Site.Author.image }}
|
||||
{{ $authorImage := resources.Get . }}
|
||||
{{ if $authorImage }}
|
||||
|
|
|
@ -1,4 +1,5 @@
|
|||
<span>
|
||||
<span id="likes_{{ .File.Path }}" title="likes">{{- i18n "article.likes" 0 | markdownify | emojify -}}</span>
|
||||
<span id="likes_{{ .File.Path }}" title="likes">0</span>
|
||||
<span>{{ partial "icon.html" "heart" }}</span>
|
||||
</span>
|
||||
{{- /* Trim EOF */ -}}
|
|
@ -1,4 +1,5 @@
|
|||
<span id="views_{{ .File.Path }}" title="views">
|
||||
{{- i18n "article.views" 0 | markdownify | emojify -}}
|
||||
<span>
|
||||
<span id="views_{{ .File.Path }}" title="views">0</span>
|
||||
<span>{{ partial "icon.html" "eye" }}</span>
|
||||
</span>
|
||||
{{- /* Trim EOF */ -}}
|
||||
|
|
24
layouts/partials/series.html
Normal file
|
@ -0,0 +1,24 @@
|
|||
{{ if .Params.series }}
|
||||
<details style="margin-left:0px" class="mt-2 mb-5 overflow-hidden rounded-lg ltr:-ml-5 ltr:pl-5 rtl:-mr-5 rtl:pr-5" {{ if .Params.seriesOpened | default (.Site.Params.article.seriesOpened | default false) }} open {{ end }}>
|
||||
<summary
|
||||
class="py-1 text-lg font-semibold cursor-pointer bg-primary-200 text-neutral-800 ltr:-ml-5 ltr:pl-5 rtl:-mr-5 rtl:pr-5 dark:bg-primary-800 dark:text-neutral-100">
|
||||
{{ index .Params.series 0 }} - This article is part of a series.
|
||||
</summary>
|
||||
{{ range $post := sort (index .Site.Taxonomies.series (index .Params.series 0 | urlize)) "Params.series_order" }}
|
||||
{{ if eq $post.Permalink $.Page.Permalink }}
|
||||
<div
|
||||
class="py-1 border-dotted border-neutral-300 ltr:-ml-5 ltr:border-l ltr:pl-5 rtl:-mr-5 rtl:border-r rtl:pr-5 dark:border-neutral-600">
|
||||
Part {{ $post.Params.series_order }}: This Article
|
||||
</div>
|
||||
{{ else }}
|
||||
<div
|
||||
class="py-1 border-dotted border-neutral-300 ltr:-ml-5 ltr:border-l ltr:pl-5 rtl:-mr-5 rtl:border-r rtl:pr-5 dark:border-neutral-600">
|
||||
<a href="{{$post.Permalink}}">
|
||||
Part {{ $post.Params.series_order }}: {{ $post.Params.title}}
|
||||
</a>
|
||||
</div>
|
||||
{{end}}
|
||||
{{end}}
|
||||
|
||||
</details>
|
||||
{{end}}
|
34
package-lock.json
generated
|
@ -1,12 +1,12 @@
|
|||
{
|
||||
"name": "hugo-blowfish-theme",
|
||||
"version": "1.3.1",
|
||||
"version": "2.4.5",
|
||||
"lockfileVersion": 2,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "hugo-blowfish-theme",
|
||||
"version": "1.3.1",
|
||||
"version": "2.4.5",
|
||||
"hasInstallScript": true,
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
|
@ -20,7 +20,7 @@
|
|||
"chart.js": "^3.9.1",
|
||||
"fuse.js": "^6.6.2",
|
||||
"katex": "^0.16.0",
|
||||
"mermaid": "^9.1.6",
|
||||
"mermaid": "^9.1.7",
|
||||
"prettier": "^2.7.1",
|
||||
"prettier-plugin-go-template": "^0.0.13",
|
||||
"prettier-plugin-tailwindcss": "^0.1.13",
|
||||
|
@ -1073,9 +1073,9 @@
|
|||
"integrity": "sha512-+HlytyjlPKnIG8XuRG8WvmBP8xs8P71y+SKKS6ZXWoEgLuePxtDoUEiH7WkdePWrQ5JBpE6aoVqfZfJUQkjXwA=="
|
||||
},
|
||||
"node_modules/dompurify": {
|
||||
"version": "2.3.10",
|
||||
"resolved": "https://registry.npmjs.org/dompurify/-/dompurify-2.3.10.tgz",
|
||||
"integrity": "sha512-o7Fg/AgC7p/XpKjf/+RC3Ok6k4St5F7Q6q6+Nnm3p2zGWioAY6dh0CbbuwOhH2UcSzKsdniE/YnE2/92JcsA+g==",
|
||||
"version": "2.4.0",
|
||||
"resolved": "https://registry.npmjs.org/dompurify/-/dompurify-2.4.0.tgz",
|
||||
"integrity": "sha512-Be9tbQMZds4a3C6xTmz68NlMfeONA//4dOavl/1rNw50E+/QO0KVpbcU0PcaW0nsQxurXls9ZocqFxk8R2mWEA==",
|
||||
"dev": true
|
||||
},
|
||||
"node_modules/fast-glob": {
|
||||
|
@ -1383,16 +1383,16 @@
|
|||
}
|
||||
},
|
||||
"node_modules/mermaid": {
|
||||
"version": "9.1.6",
|
||||
"resolved": "https://registry.npmjs.org/mermaid/-/mermaid-9.1.6.tgz",
|
||||
"integrity": "sha512-oBuQk7s55wQgEgH/AK0GYY8U0kBqOIGK9QlJL+VYxh+1kZQtU9tNwoy0gWCfBJDaFIRdfpc/fm9PagaIXg6XFQ==",
|
||||
"version": "9.1.7",
|
||||
"resolved": "https://registry.npmjs.org/mermaid/-/mermaid-9.1.7.tgz",
|
||||
"integrity": "sha512-MRVHXy5FLjnUQUG7YS3UN9jEN6FXCJbFCXVGJQjVIbiR6Vhw0j/6pLIjqsiah9xoHmQU6DEaKOvB3S1g/1nBPA==",
|
||||
"dev": true,
|
||||
"dependencies": {
|
||||
"@braintree/sanitize-url": "^6.0.0",
|
||||
"d3": "^7.0.0",
|
||||
"dagre": "^0.8.5",
|
||||
"dagre-d3": "^0.6.4",
|
||||
"dompurify": "2.3.10",
|
||||
"dompurify": "2.4.0",
|
||||
"graphlib": "^2.1.8",
|
||||
"khroma": "^2.0.0",
|
||||
"moment-mini": "2.24.0",
|
||||
|
@ -2831,9 +2831,9 @@
|
|||
"integrity": "sha512-+HlytyjlPKnIG8XuRG8WvmBP8xs8P71y+SKKS6ZXWoEgLuePxtDoUEiH7WkdePWrQ5JBpE6aoVqfZfJUQkjXwA=="
|
||||
},
|
||||
"dompurify": {
|
||||
"version": "2.3.10",
|
||||
"resolved": "https://registry.npmjs.org/dompurify/-/dompurify-2.3.10.tgz",
|
||||
"integrity": "sha512-o7Fg/AgC7p/XpKjf/+RC3Ok6k4St5F7Q6q6+Nnm3p2zGWioAY6dh0CbbuwOhH2UcSzKsdniE/YnE2/92JcsA+g==",
|
||||
"version": "2.4.0",
|
||||
"resolved": "https://registry.npmjs.org/dompurify/-/dompurify-2.4.0.tgz",
|
||||
"integrity": "sha512-Be9tbQMZds4a3C6xTmz68NlMfeONA//4dOavl/1rNw50E+/QO0KVpbcU0PcaW0nsQxurXls9ZocqFxk8R2mWEA==",
|
||||
"dev": true
|
||||
},
|
||||
"fast-glob": {
|
||||
|
@ -3074,16 +3074,16 @@
|
|||
"integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg=="
|
||||
},
|
||||
"mermaid": {
|
||||
"version": "9.1.6",
|
||||
"resolved": "https://registry.npmjs.org/mermaid/-/mermaid-9.1.6.tgz",
|
||||
"integrity": "sha512-oBuQk7s55wQgEgH/AK0GYY8U0kBqOIGK9QlJL+VYxh+1kZQtU9tNwoy0gWCfBJDaFIRdfpc/fm9PagaIXg6XFQ==",
|
||||
"version": "9.1.7",
|
||||
"resolved": "https://registry.npmjs.org/mermaid/-/mermaid-9.1.7.tgz",
|
||||
"integrity": "sha512-MRVHXy5FLjnUQUG7YS3UN9jEN6FXCJbFCXVGJQjVIbiR6Vhw0j/6pLIjqsiah9xoHmQU6DEaKOvB3S1g/1nBPA==",
|
||||
"dev": true,
|
||||
"requires": {
|
||||
"@braintree/sanitize-url": "^6.0.0",
|
||||
"d3": "^7.0.0",
|
||||
"dagre": "^0.8.5",
|
||||
"dagre-d3": "^0.6.4",
|
||||
"dompurify": "2.3.10",
|
||||
"dompurify": "2.4.0",
|
||||
"graphlib": "^2.1.8",
|
||||
"khroma": "^2.0.0",
|
||||
"moment-mini": "2.24.0",
|
||||
|
|
|
@ -1,6 +1,6 @@
|
|||
{
|
||||
"name": "hugo-blowfish-theme",
|
||||
"version": "2.0.0",
|
||||
"version": "2.4.5",
|
||||
"description": "Blowfish theme for Hugo",
|
||||
"scripts": {
|
||||
"preinstall": "rimraf assets/vendor",
|
||||
|
|