diff options
author | uPagge <upagge@mail.ru> | 2020-12-15 15:33:56 +0300 |
---|---|---|
committer | uPagge <upagge@mail.ru> | 2020-12-15 15:33:56 +0300 |
commit | df2b140fa3b2349b996a12769f2f4c535c7c2c78 (patch) | |
tree | 198d65978835e62fbeb6168f6c7b74eed0db5879 | |
parent | e362ebc9788dabbe44e0e7cc4bced9bb5b1b1aaf (diff) |
pre-release documentation 1.1.0
-rw-r--r-- | README.md | 2 | ||||
-rw-r--r-- | assets/css/_ublogger.scss | 8 | ||||
-rw-r--r-- | assets/css/_ublogger_media.scss | 4 | ||||
-rw-r--r-- | assets/css/_variables.scss | 6 | ||||
-rw-r--r-- | exampleSite/config.toml | 2 | ||||
-rw-r--r-- | exampleSite/content/posts/theme-documentation-basics/index.en.md | 19 | ||||
-rw-r--r-- | exampleSite/content/posts/theme-documentation-content/index.en.md | 50 | ||||
-rw-r--r-- | images/Apple-Devices-Preview.jpg | bin | 0 -> 1282974 bytes | |||
-rw-r--r-- | images/Apple-Devices-Preview.png | bin | 227412 -> 0 bytes | |||
-rw-r--r-- | layouts/_default/summary.html | 16 |
10 files changed, 83 insertions, 24 deletions
@@ -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 Binary files differnew file mode 100644 index 0000000..d0fb3f3 --- /dev/null +++ b/images/Apple-Devices-Preview.jpg diff --git a/images/Apple-Devices-Preview.png b/images/Apple-Devices-Preview.png Binary files differdeleted file mode 100644 index ac7709b..0000000 --- a/images/Apple-Devices-Preview.png +++ /dev/null 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 -}} |