Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/uPagge/uBlogger.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authoruPagge <upagge@mail.ru>2020-12-15 15:33:56 +0300
committeruPagge <upagge@mail.ru>2020-12-15 15:33:56 +0300
commitdf2b140fa3b2349b996a12769f2f4c535c7c2c78 (patch)
tree198d65978835e62fbeb6168f6c7b74eed0db5879
parente362ebc9788dabbe44e0e7cc4bced9bb5b1b1aaf (diff)
pre-release documentation 1.1.0
-rw-r--r--README.md2
-rw-r--r--assets/css/_ublogger.scss8
-rw-r--r--assets/css/_ublogger_media.scss4
-rw-r--r--assets/css/_variables.scss6
-rw-r--r--exampleSite/config.toml2
-rw-r--r--exampleSite/content/posts/theme-documentation-basics/index.en.md19
-rw-r--r--exampleSite/content/posts/theme-documentation-content/index.en.md50
-rw-r--r--images/Apple-Devices-Preview.jpgbin0 -> 1282974 bytes
-rw-r--r--images/Apple-Devices-Preview.pngbin227412 -> 0 bytes
-rw-r--r--layouts/_default/summary.html16
10 files changed, 83 insertions, 24 deletions
diff --git a/README.md b/README.md
index 66e7ef1..22640c2 100644
--- a/README.md
+++ b/README.md
@@ -11,7 +11,7 @@ It is based on the original [LoveIt Theme](https://github.com/dillonzq/LoveIt).
Since the three themes have a similar look, if you have questions about their differences,
read [Why choose uBlogger](#why-choose-ublogger) so that you can choose the one that works best for you.
-![Hugo Theme uBlogger](https://github.com/upagge/uBlogger/raw/master/images/Apple-Devices-Preview.png)
+![Hugo Theme uBlogger](https://github.com/upagge/uBlogger/raw/master/images/Apple-Devices-Preview.jpg)
## :warning: Information for those who move with LoveIt theme :warning:
diff --git a/assets/css/_ublogger.scss b/assets/css/_ublogger.scss
index da0b765..f0334e7 100644
--- a/assets/css/_ublogger.scss
+++ b/assets/css/_ublogger.scss
@@ -24,11 +24,11 @@ body {
}
}
-.mini-title {
+.summary-title {
margin: 0;
}
-.mini-content {
+.summary-content {
padding-top: 10px;
padding-bottom: 10px;
}
@@ -70,7 +70,7 @@ article {
}
.article-mini {
- border-radius: $article-mini-border-radius;
+ border-radius: $article-summary-border-radius;
cursor: pointer;
}
@@ -205,7 +205,7 @@ a.post-tag-summary{
.single {
- .mini-post-meta {
+ .summary-post-meta {
font-size: 0.8rem;
.author {
diff --git a/assets/css/_ublogger_media.scss b/assets/css/_ublogger_media.scss
index 62f7903..f0b8eff 100644
--- a/assets/css/_ublogger_media.scss
+++ b/assets/css/_ublogger_media.scss
@@ -20,8 +20,8 @@
.featured-image-preview, .featured-image {
img {
- border-top-left-radius: $article-mini-image-border-radius;
- border-top-right-radius: $article-mini-image-border-radius;
+ border-top-left-radius: $article-summary-image-border-radius;
+ border-top-right-radius: $article-summary-image-border-radius;
}
}
diff --git a/assets/css/_variables.scss b/assets/css/_variables.scss
index 0c6a752..772cc61 100644
--- a/assets/css/_variables.scss
+++ b/assets/css/_variables.scss
@@ -77,9 +77,9 @@ $search-background-color: #e9e9e9 !default;
$search-background-color-dark: #363636 !default;
// ========== Header ========== //
-// ========== Mini Content ========== //
-$article-mini-border-radius: 32px;
-$article-mini-image-border-radius: 30px;
+// ========== Summary Content ========== //
+$article-summary-border-radius: 32px;
+$article-summary-image-border-radius: 30px;
// ========== Single Content ========== //
$article-border-radius: 32px;
diff --git a/exampleSite/config.toml b/exampleSite/config.toml
index a49ebfe..c835a7e 100644
--- a/exampleSite/config.toml
+++ b/exampleSite/config.toml
@@ -152,7 +152,7 @@ enableEmoji = true
disclaimer = ""
# Home page posts
[languages.en.params.home.posts]
- enable = true
+ enable = false
# special amount of posts in each home posts page
paginate = 6
# Social config in home page
diff --git a/exampleSite/content/posts/theme-documentation-basics/index.en.md b/exampleSite/content/posts/theme-documentation-basics/index.en.md
index 13f9058..f0022f5 100644
--- a/exampleSite/content/posts/theme-documentation-basics/index.en.md
+++ b/exampleSite/content/posts/theme-documentation-basics/index.en.md
@@ -1,13 +1,13 @@
---
title: "Theme Documentation - Basics"
date: 2020-03-06T21:29:01+08:00
-lastmod: 2020-12-05T18:55:56+03:00
+lastmod: 2020-12-15T11:21:43+03:00
description: "Discover what the Hugo - uBlog theme is all about and the core-concepts behind it."
resources:
- name: "featured-image"
src: "featured-image.jpg"
-upd: "Since the template began to support uPagge, you can not do without names. You can find the changes by tag 1.0.0."
+upd: "Since the template began to support uPagge, you can not do without names. You can find the changes by tag 1.x.x."
page:
theme: "wide"
@@ -430,10 +430,23 @@ Please open the code block below to view the complete sample configuration :(far
# {{< version 0.2.4 >}} whether to show the full text content in RSS
rssFullText = false
# {{< version 1.1.0 new >}} Post display settings on the page
- [params.page.mini]
+ [params.summary]
# {{< version 1.1.0 new >}} Display previews on the page of posts
hiddenImage = false
+ # {{< version 1.1.0 new >}} Allows you to hide the description
hiddenDescription = false
+ # {{< version 1.1.0 new >}} Allows you to hide the title
+ hiddenTitle = false
+ # {{< version 1.1.0 new >}} Tag display settings
+ [params.summary.tags]
+ # {{< version 1.1.0 new >}} One of the options for displaying tags
+ theme = "image"
+ # {{< version 1.1.0 new >}} Text color
+ color = "white"
+ # {{< version 1.1.0 new >}} Backing color
+ background = "black"
+ # {{< version 1.1.0 new >}} Tag transparency
+ transparency = 0.9
# {{< version 0.2.0 >}} Table of the contents config
[params.page.toc]
# whether to enable the table of the contents
diff --git a/exampleSite/content/posts/theme-documentation-content/index.en.md b/exampleSite/content/posts/theme-documentation-content/index.en.md
index c409faf..2508053 100644
--- a/exampleSite/content/posts/theme-documentation-content/index.en.md
+++ b/exampleSite/content/posts/theme-documentation-content/index.en.md
@@ -1,11 +1,13 @@
---
title: "Theme Documentation - Content"
date: 2020-03-05T15:58:26+08:00
-lastmod: 2020-03-05T15:58:26+08:00
+lastmod: 2020-03-15T11:26:13+08:00
description: "Find out how to create and organize your content quickly and intuitively in uBlogger theme."
resources:
- name: "featured-image"
src: "featured-image.jpg"
+
+upd: "You can now customize the post preview design"
tags: ["content", "Markdown"]
categories: ["documentation"]
@@ -92,10 +94,22 @@ page:
theme: ""
# {{< version 1.1.0 new >}} Post display settings on the page
-mini:
+summary:
# {{< version 1.1.0 new >}} Display previews on the page of posts
hiddenImage: false
+ # {{< version 1.1.0 new >}} Allows you to hide the description
hiddenDescription: false
+ # {{< version 1.1.0 new >}} Allows you to hide the title
+ hiddenTitle: true
+ tags:
+ # {{< version 1.1.0 new >}} One of the options for displaying tags
+ theme: "image"
+ # {{< version 1.1.0 new >}} Text color
+ color: "white"
+ # {{< version 1.1.0 new >}} Backing color
+ background: "black"
+ # {{< version 1.1.0 new >}} Tag transparency
+ transparency: 0.9
tags: []
categories: []
featuredImage: ""
@@ -265,6 +279,38 @@ You can use this to set emoji or partition number.
![Example with Emoji](h-emoji.jpg 'Example with Emoji')
+### Summary display settings
+
+You can customize the summary view to your taste by changing the following parameters.
+
+```yaml
+summary:
+ hiddenImage: false
+ hiddenDescription: false
+ hiddenTitle: true
+ tags:
+ theme: "image"
+ color: "white"
+ background: "black"
+ transparency: 0.9
+```
+
+What kinds of tags are available:
+* image. Tags on the picture
+* footer. Tags in footer summary
+* under-footer. Tags under summary
+
+These parameters, together with the scss override, allow you to customize the display quite flexibly.
+
+```css
+$article-summary-border-radius: 32px;
+$article-summary-image-border-radius: 30px;
+```
+
+
+
+The global setting is, as always, available in the main configuration file
+
## 3 Content Summaries
**uBlogger** theme uses the summary of the content to display abstract information in the home page. Hugo can generate summaries of your content.
diff --git a/images/Apple-Devices-Preview.jpg b/images/Apple-Devices-Preview.jpg
new file mode 100644
index 0000000..d0fb3f3
--- /dev/null
+++ b/images/Apple-Devices-Preview.jpg
Binary files differ
diff --git a/images/Apple-Devices-Preview.png b/images/Apple-Devices-Preview.png
deleted file mode 100644
index ac7709b..0000000
--- a/images/Apple-Devices-Preview.png
+++ /dev/null
Binary files differ
diff --git a/layouts/_default/summary.html b/layouts/_default/summary.html
index 3aac10b..2ee2e47 100644
--- a/layouts/_default/summary.html
+++ b/layouts/_default/summary.html
@@ -1,10 +1,10 @@
{{- $params := .Params | merge .Site.Params -}}
-{{- $tagsStyle := $params.mini.tags -}}
-{{- $tagsTheme := $params.mini.tags.theme | default "image" -}}
+{{- $tagsStyle := $params.summary.tags -}}
+{{- $tagsTheme := $params.summary.tags.theme | default "image" -}}
<article onclick="location.href='{{ $.RelPermalink }}'" class="single summary summary-animation" itemscope itemtype="http://schema.org/Article" style="{{- if eq $tagsTheme "under-footer" -}}{{- with $.Params.tags -}}margin-bottom:0{{- end -}}{{- end -}}">
{{- /* Featured image */ -}}
- {{- if not $params.mini.hiddenImage -}}
+ {{- if not $params.summary.hiddenImage -}}
{{- $image := $params.featuredimagepreview | default $params.featuredimage -}}
{{- with .Resources.GetMatch "featured-image" -}}
{{- $image = .RelPermalink -}}
@@ -30,13 +30,13 @@
{{- end -}}
<div class="article-text">
{{- /* Title */ -}}
- <h2 class="mini-title" itemprop="name headline">
+ <h2 class="summary-title" itemprop="name headline">
{{ .Title }}
</h2>
- {{- if not $params.mini.hiddenMeta -}}
+ {{- if not $params.summary.hiddenMeta -}}
{{- /* Meta */ -}}
- <div class="post-meta mini-post-meta">
+ <div class="post-meta summary-post-meta">
{{- $authorName := $params.author | default .Site.Author.name | default " " -}}
{{- if not (eq $authorName " ") -}}
{{ $author := index .Site.Data.authors $authorName }}
@@ -76,8 +76,8 @@
{{- end -}}
{{- /* Summary content */ -}}
- {{- if not $params.mini.hiddenDescription -}}
- <div class="content mini-content">
+ {{- if not $params.summary.hiddenDescription -}}
+ <div class="content summary-content">
{{- with .Summary -}}
{{- dict "Content" . "Ruby" $params.ruby "Fraction" $params.fraction "Fontawesome" $params.fontawesome | partial "function/content.html" | safeHTML -}}
{{- else -}}