jekyll-theme-fica 0.2.0 → 0.3.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.github/ISSUE_TEMPLATE/bug_report.md +38 -0
- data/.github/ISSUE_TEMPLATE/feature_request.md +20 -0
- data/.github/workflows/ci.yaml +5 -2
- data/.github/workflows/ci.yaml.orig +34 -0
- data/404.html +12 -10
- data/License.md +2 -8
- data/README.md +53 -49
- data/_includes/Footer.html +88 -85
- data/_includes/Head.html +24 -12
- data/_includes/Header.html +21 -34
- data/_includes/assets/BTT.html +8 -0
- data/_includes/{Google-Analytics.html → assets/Google-Analytics.html} +12 -12
- data/_includes/assets/anchor-headings.html +164 -0
- data/_includes/assets/comments.html +16 -0
- data/_includes/assets/toc.html +174 -0
- data/_layouts/default.html +16 -14
- data/_layouts/home.html +25 -67
- data/_layouts/page.html +5 -3
- data/_layouts/post.html +48 -52
- data/_layouts/post_list.html +103 -0
- data/_posts/2022-03-31-To-Know-if-the-nav-works.md +9 -8
- data/_posts/{2022-04-1-Demo.md → 2022-04-1-Elements-of-Fica-Theme.md} +111 -113
- data/_posts/2022-04-5-Getting-Started.md +149 -149
- data/_posts/2022-04-6-Creating-a-new-post.md +144 -136
- data/_posts/2023-04-24-Fica-Customization.md +43 -0
- data/_sass/base.scss +437 -0
- data/_sass/{themes/dark theme/highlight.scss → colors/dark-theme/highlight.scss} +362 -362
- data/_sass/{themes/dark theme/theme-dark.scss → colors/dark-theme/theme-dark.scss} +132 -142
- data/_sass/{themes/light theme/highlight.scss → colors/light-theme/highlight.scss} +198 -198
- data/_sass/{themes/light theme/theme-light.scss → colors/light-theme/theme-light.scss} +126 -136
- data/_sass/jekyll-theme-fica.scss +1 -8
- data/_sass/layouts/Google-fonts.scss +103 -138
- data/_sass/layouts/component.scss +272 -0
- data/_sass/layouts/layout.scss +657 -718
- data/_sass/layouts/typography.scss +492 -0
- data/_sass/layouts/variable.scss +215 -0
- data/assets/css/Style.scss +4 -13
- data/assets/favicons/android-chrome-192x192.png +0 -0
- data/assets/favicons/android-chrome-512x512.png +0 -0
- data/assets/favicons/apple-touch-icon.png +0 -0
- data/assets/favicons/browserconfig.xml +9 -0
- data/assets/favicons/favicon-16x16.png +0 -0
- data/assets/favicons/favicon-32x32.png +0 -0
- data/assets/favicons/favicon.ico +0 -0
- data/assets/favicons/mstile-150x150.png +0 -0
- data/assets/favicons/safari-pinned-tab.svg +32 -0
- data/assets/favicons/site.webmanifest +19 -0
- data/assets/img/homepage-pic.png +0 -0
- data/bin/run +195 -150
- data/js/Main.js +74 -0
- data/js/back-to-top.js +39 -48
- data/logo.png +0 -0
- data/post/index.html +3 -3
- metadata +35 -32
- data/_includes/BTT.html +0 -7
- data/_layouts/post_home.html +0 -113
- data/_sass/custom/styles.scss +0 -1
- data/_sass/custom/variables.scss +0 -1
- data/_sass/layouts/base.scss +0 -579
- data/_sass/layouts/variables.scss +0 -230
- data/docs/contributing.md +0 -69
@@ -1,136 +1,144 @@
|
|
1
|
-
---
|
2
|
-
layout: post
|
3
|
-
site-title: Creating a new post
|
4
|
-
author: Involts
|
5
|
-
---
|
6
|
-
|
7
|
-
This post shows how to create a new post on the `Fica` Theme. Even if you have previous experience with Jekyll, this article is worth reading, because many features require specific variables to be set.
|
8
|
-
|
9
|
-
# Creating a File and Naming a post
|
10
|
-
|
11
|
-
Create a new file named `YYY-MM-DD-TITLE.EXTENSION` (.EXTENSION may be `.md` or `.markdown`) and put it on the `_posts` folder.
|
12
|
-
|
13
|
-
# Font Matter
|
14
|
-
|
15
|
-
Basic Font Matter
|
16
|
-
|
17
|
-
| Font Matter | Description
|
18
|
-
| --------------------------------------|------------------
|
19
|
-
| `layouts` | This specifies the layout file to use. It may be `home` layout for the homepage, `post` layout for post, `default` or `page` layout/s the original look of the site, and `post-home` layout for homepage of the post/s.
|
20
|
-
| `site-title` | This displays the website title. **EXCEPT THE HOMEPAGE**
|
21
|
-
| `author` | This is optional for the post because the authour is set on the `_config.yml` file.
|
22
|
-
| `home` | **This is only for the homepage** It displays the website title so that you will not write the website title.
|
23
|
-
| `pin` | This pins the post to the top of the post-home layout.
|
24
|
-
|
25
|
-
|
26
|
-
|
27
|
-
|
28
|
-
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
|
38
|
-
|
39
|
-
|
40
|
-
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
55
|
-
|
56
|
-
|
57
|
-
|
58
|
-
|
59
|
-
|
60
|
-
|
61
|
-
|
62
|
-
|
63
|
-
|
64
|
-
|
65
|
-
|
66
|
-
|
67
|
-
|
68
|
-
|
69
|
-
|
70
|
-
|
71
|
-
|
72
|
-
|
73
|
-
|
74
|
-
|
75
|
-
|
76
|
-
|
77
|
-
|
78
|
-
|
79
|
-
|
80
|
-
|
81
|
-
|
82
|
-
|
83
|
-
|
84
|
-
```
|
85
|
-
|
86
|
-
|
87
|
-
|
88
|
-
|
89
|
-
|
90
|
-
```
|
91
|
-
|
92
|
-
```
|
93
|
-
|
94
|
-
|
95
|
-
|
96
|
-
|
97
|
-
|
98
|
-
```
|
99
|
-
|
100
|
-
```
|
101
|
-
|
102
|
-
|
103
|
-
|
104
|
-
|
105
|
-
|
106
|
-
|
107
|
-
|
108
|
-
```
|
109
|
-
|
110
|
-
|
111
|
-
|
112
|
-
|
113
|
-
|
114
|
-
|
115
|
-
|
116
|
-
|
117
|
-
|
118
|
-
|
119
|
-
{
|
120
|
-
|
121
|
-
|
122
|
-
|
123
|
-
|
124
|
-
|
125
|
-
|
126
|
-
````
|
127
|
-
|
128
|
-
|
129
|
-
|
130
|
-
|
131
|
-
|
132
|
-
|
133
|
-
|
134
|
-
|
135
|
-
|
136
|
-
|
1
|
+
---
|
2
|
+
layout: post
|
3
|
+
site-title: Creating a new post
|
4
|
+
author: Involts
|
5
|
+
---
|
6
|
+
|
7
|
+
This post shows how to create a new post on the `Fica` Theme. Even if you have previous experience with Jekyll, this article is worth reading, because many features require specific variables to be set.
|
8
|
+
|
9
|
+
# Creating a File and Naming a post
|
10
|
+
|
11
|
+
Create a new file named `YYY-MM-DD-TITLE.EXTENSION` (.EXTENSION may be `.md` or `.markdown`) and put it on the `_posts` folder.
|
12
|
+
|
13
|
+
# Font Matter
|
14
|
+
|
15
|
+
Basic Font Matter
|
16
|
+
|
17
|
+
| Font Matter | Description
|
18
|
+
| --------------------------------------|------------------
|
19
|
+
| `layouts` | This specifies the layout file to use. It may be `home` layout for the homepage, `post` layout for post, `default` or `page` layout/s the original look of the site, and `post-home` layout for homepage of the post/s.
|
20
|
+
| `site-title` | This displays the website title. **EXCEPT THE HOMEPAGE**
|
21
|
+
| `author` | This is optional for the post because the authour is set on the `_config.yml` file.
|
22
|
+
| `home` | **This is only for the homepage** It displays the website title so that you will not write the website title.
|
23
|
+
| `pin` | This pins the post to the top of the post-home layout.
|
24
|
+
| `post_toc: false` | This hides the TOC(Table of Contents) in post
|
25
|
+
|
26
|
+
Examples:
|
27
|
+
|
28
|
+
- Homepage:
|
29
|
+
|
30
|
+
```yml
|
31
|
+
---
|
32
|
+
layout: home
|
33
|
+
home: true
|
34
|
+
---
|
35
|
+
|
36
|
+
```
|
37
|
+
|
38
|
+
- About
|
39
|
+
|
40
|
+
```yml
|
41
|
+
---
|
42
|
+
layout: default
|
43
|
+
site-title: About
|
44
|
+
permalink: /About/
|
45
|
+
---
|
46
|
+
|
47
|
+
```
|
48
|
+
|
49
|
+
- Post List
|
50
|
+
|
51
|
+
```yml
|
52
|
+
---
|
53
|
+
layout: post_list
|
54
|
+
site-title: post
|
55
|
+
---
|
56
|
+
```
|
57
|
+
|
58
|
+
- Post
|
59
|
+
|
60
|
+
```yml
|
61
|
+
---
|
62
|
+
layout: post
|
63
|
+
site-title: Creating a new post
|
64
|
+
author: Involts
|
65
|
+
---
|
66
|
+
```
|
67
|
+
|
68
|
+
if you want to pin the post:
|
69
|
+
```yml
|
70
|
+
---
|
71
|
+
layout: post
|
72
|
+
site-title: Creating a new post
|
73
|
+
author: Involts
|
74
|
+
pin: true
|
75
|
+
---
|
76
|
+
```
|
77
|
+
|
78
|
+
if you want to remove TOC in post
|
79
|
+
```yml
|
80
|
+
layout: post
|
81
|
+
site-title: Creating a new post
|
82
|
+
author: Involts
|
83
|
+
post_toc: false
|
84
|
+
```
|
85
|
+
|
86
|
+
# Syntax
|
87
|
+
|
88
|
+
- Inline Code
|
89
|
+
|
90
|
+
```
|
91
|
+
`inline code part`
|
92
|
+
```
|
93
|
+
|
94
|
+
- Code Block
|
95
|
+
|
96
|
+
Markdown symbol ``` can easily create a code block as follows:
|
97
|
+
|
98
|
+
```
|
99
|
+
Plaintext Code Snippet.
|
100
|
+
```
|
101
|
+
### Specifying Language in Code Block
|
102
|
+
|
103
|
+
Markdown symbol ```{language} can easily create a code block as follows:
|
104
|
+
|
105
|
+
````yml
|
106
|
+
```yml
|
107
|
+
title: Fica Theme
|
108
|
+
```
|
109
|
+
````
|
110
|
+
|
111
|
+
### Line Number
|
112
|
+
|
113
|
+
All languages except `plaintext`, `console`, and `terminal` will display line numbers. When you want to hide the line number of a code block, add the class `nolineno` to it:
|
114
|
+
|
115
|
+
````markdown
|
116
|
+
```bash
|
117
|
+
echo 'No more line numbers'
|
118
|
+
```
|
119
|
+
{: .nolineno }
|
120
|
+
````
|
121
|
+
|
122
|
+
#### Liquid Codes
|
123
|
+
|
124
|
+
If you want to display the `Liquid` snippet, surround the liquid code with `{% raw %}` and `{% endraw %}`:
|
125
|
+
|
126
|
+
````markdown
|
127
|
+
{% raw %}
|
128
|
+
```liquid
|
129
|
+
{% if product.title contains 'Pack' %}
|
130
|
+
This product's title contains the word Pack.
|
131
|
+
{% endif %}
|
132
|
+
```
|
133
|
+
{% endraw %}
|
134
|
+
````
|
135
|
+
|
136
|
+
Or adding `render_with_liquid: false` (Requires Jekyll 4.0 or higher) to the post's YAML block.
|
137
|
+
|
138
|
+
## Learn More
|
139
|
+
|
140
|
+
For more knowledge about Jekyll posts, visit the [Jekyll Docs: Posts](https://jekyllrb.com/docs/posts/).
|
141
|
+
|
142
|
+
|
143
|
+
|
144
|
+
|
@@ -0,0 +1,43 @@
|
|
1
|
+
---
|
2
|
+
layout: post
|
3
|
+
site-title: Fica Customization
|
4
|
+
author: Involts
|
5
|
+
---
|
6
|
+
|
7
|
+
The following shows how to customize the Theme.
|
8
|
+
|
9
|
+
# Code infrastructure
|
10
|
+
|
11
|
+
## Customizing the Styles, Variables and Color Scheme:
|
12
|
+
|
13
|
+
if you like to override the default styles of the theme, go to `_sass/Custom/Styles.scss`.
|
14
|
+
|
15
|
+
if you like to override the default Variables of the theme, go to `_sass/Custom/Variable.scss`.
|
16
|
+
|
17
|
+
if you like to change the colors of the Dark Theme in the site, go to `_sass/themes/dark theme/Dark_Theme.scss`.
|
18
|
+
|
19
|
+
if you like to change the colors of the Light Theme in the site, go to `_sass/themes/dark theme/Light_Theme.scss`.
|
20
|
+
|
21
|
+
Want to change [the themes?](#how-to-change-dark-mode-to-light-mode)
|
22
|
+
## Customizing Google Analytics code
|
23
|
+
|
24
|
+
Google has released several iterations to their Google Analytics code over the years since this theme was first created. If you would like to take advantage of the latest code, paste it into `_includes/Google-Analytics.html` in your Jekyll site.
|
25
|
+
## Change dark mode to light mode
|
26
|
+
|
27
|
+
# Layouts
|
28
|
+
## Replace the logo on the header
|
29
|
+
Replace logo.png at the top of your site.
|
30
|
+
Make sure that the logo is 36x36 pixels to avoid overlapping the title.
|
31
|
+
|
32
|
+
## Replace the picture at the homepage ?
|
33
|
+
|
34
|
+
Replace `assets/img/homepage-pic.png`
|
35
|
+
|
36
|
+
Replace:
|
37
|
+
|
38
|
+
```diff
|
39
|
+
- "themes/dark theme/theme-dark",
|
40
|
+
+ "themes/light theme/theme-light",
|
41
|
+
```
|
42
|
+
|
43
|
+
in `_sass/jekyll-theme-fica.scss`.
|