jekyll-theme-fica 0.1.5 → 0.2.0

data/_posts/2022-04-5-Getting-Started.md

@@ -0,0 +1,149 @@
+---
+layout: post
+site-title: Getting Started
+author: Involts
+pin: true
+---
+
+# Prerequisites
+
+Follow the instructions in [jekyll Docs](https://jekyllrb.com/docs/installation/) to install `Ruby`, `RubyGems`, and `Bundler`. You may also install [Git](https://git-scm.com/)
+
+# Installation
+
+## Creating a new site
+
+1. [Using RubyGems](https://rubygems.org/gems/jekyll-theme-fica) - Easy to upgrade, but it is not convenient with customizing the Theme.
+
+1. [Forking using Github](https://github.com/Involts/jekyll-theme-fica/generate) - Not easy to upgrade, but you needs familiar with [Jekyll](https://jekyllrb.com), [Git](https://git-scm.com/) or [Github](https://github.com/).
+
+## Option 1. Using RubyGems
+
+Copy the Gemfile `gem 'jekyll-theme-fica', '~> 0.2.0'`, paste it on the `Gemfile` file then run 
+
+```bash
+$ bin/run insdep
+```
+{: .nolineno}
+or
+```bash
+$ bundle install
+```
+{: .nolineno}
+
+and run
+
+```bash
+$ bin/run server
+```
+{: .nolineno}
+or
+```bash
+$ bundle exec jekyll serve
+```
+{: .nolineno}
+
+
+
+
+## Option 2. Forking Github
+
+name it `<GH_USERNAME>.github.io`, where `GH_USERNAME` represents your GitHub username.
+
+ then run:
+
+```bash
+$ bin/run insdep
+```
+{: .nolineno}
+
+and run
+
+```bash
+$ bin/run server
+```
+{: .nolineno}
+
+# Usage
+
+### Configuration
+
+> Before publishing the site to github-pages, replace the varable of baseurl. If you have brought a doman remove the varable in the `_config.yml` file 
+`baseurl: /jekyll-fica-theme`
+{: .prompt-warning }
+
+Fica Theme will respect the following variables, in your `_config.yml` file:
+
+```yml
+title: [The title of your site]
+description: [A short description of your site's purpose]
+
+socials:
+  # Change Involts to your full name.
+  name: [The auther of the site]
+  # it also be the copyright owner's link
+  auther-link: [Link of the auther]
+```
+
+Change the links of your site header:
+
+```yml
+header:
+    external_link_1: true # if false, it adds the baseurl of the site
+    header_name_1: Download
+    header_link_1: https://github.com/Involts/jekyll-theme-fica/zipball/master
+
+    external_link_2: false # if false, it adds the baseurl of the site
+    header_name_2: Post
+    header_link_2: /Post/
+    
+    external_link_3: false # if false, it adds the baseurl of the site
+    header_name_3: About
+    header_link_3: /About/
+```
+
+Change the links of your site header:
+
+ > If you want to create a external link in the headers Links remove `{{site.baseurl}}` on `_includes/Header/html` **BELLOW**
+ {: .prompt-info }
+
+
+{% raw %}
+```diff
+header:
+    external_link_1: true # if false, it adds the baseurl of the site
+    header_name_1: Download
+    header_link_1: https://github.com/Involts/jekyll-theme-fica/zipball/master
+-   external_link_2: false # if false, it adds the baseurl of the site
++   external_link_2: true # if false, it adds the baseurl of the site
+    header_name_2: Post
+    header_link_2: /Post/
+    
+-   external_link_3: false # if false, it adds the baseurl of the site
++   external_link_3: true # if false, it adds the baseurl of the site
+    header_name_3: About
+    header_link_3: /About/
+  ```
+{% endraw %}  
+
+#  Upgrading
+  Depending on how you use the theme:
+
+- if you are using the [theme gem](https://rubygems.org/gems/jekyll-theme-fica). Run:
+
+```bash
+$ bin/run upgrade
+```
+{: .nolineno}
+
+Please refer to the [Upgrade Guide](https://github.com/Involts/jekyll-theme-fica/wiki/Theme-Upgrade-Guide) to keep your repo’s files in sync with the latest version of the theme.
+
+- If you [forked](https://github.com/Involts/jekyll-theme-fica/fork) it on [GitHub](https://github.com/Involts/jekyll-theme-fica), then merge the [latest tags](https://github.com/Involts/jekyll-theme-fica/tags) into your Jekyll site to complete the upgrade. The merge is likely to conflict with your local modifications. Please be patient and careful to resolve these conflicts.
+
+
+
+
+
+
+
+

data/_posts/2022-04-6-Creating-a-new-post.md

@@ -0,0 +1,136 @@
+---
+layout: post
+site-title: Creating a new post
+author: Involts
+---
+
+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.
+
+# Creating a File and Naming a post
+
+Create a new file named `YYY-MM-DD-TITLE.EXTENSION` (.EXTENSION may be `.md` or `.markdown`) and put it on the `_posts` folder.
+
+# Font Matter
+
+Basic Font Matter
+
+|             Font Matter               |  Description
+| --------------------------------------|------------------
+| `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. 
+| `site-title`                          | This displays the website title. **EXCEPT THE HOMEPAGE**
+| `author`                              |  This is optional for the post because the authour is set on the `_config.yml` file.
+| `home`                                | **This is only for the homepage** It displays the website title so that you will not write the website title.
+| `pin`                              | This pins the post to the top of the post-home layout.
+
+Examples:
+
+- Homepage:
+
+```yml
+---
+layout: home
+home: true
+---
+
+```
+
+- About
+
+```yml
+---
+layout: default
+site-title: About
+permalink: /About/
+---
+
+```
+
+- Post Home
+
+```yml
+---
+layout: post_home
+site-title: post
+---
+```
+
+- Post
+
+```yml
+---
+layout: post
+site-title: Creating a new post
+author: Involts
+---
+```
+
+if it is pinned:
+```yml
+---
+layout: post
+site-title: Creating a new post
+author: Involts
+pin: true
+---
+```
+
+
+# Syntax
+
+- Inline Code
+
+```
+`inline code part`
+```
+
+- Code Block
+
+Markdown symbol ``` can easily create a code block as follows:
+
+```
+Plaintext Code Snippet.
+```
+### Specifying Language in Code Block
+
+  Markdown symbol ```{language} can easily create a code block as follows:
+
+````yml
+```yml
+    title: Fica Theme
+```
+````
+
+### Line Number
+
+ 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:
+
+````markdown
+```bash
+echo 'No more line numbers'
+```
+{: .nolineno }
+````
+
+#### Liquid Codes
+
+If you want to display the `Liquid` snippet, surround the liquid code with `{% raw %}` and `{% endraw %}`:
+
+````markdown
+{% raw %}
+```liquid
+{% if product.title contains 'Pack' %}
+  This product's title contains the word Pack.
+{% endif %}
+```
+{% endraw %}
+````
+
+Or adding `render_with_liquid: false` (Requires Jekyll 4.0 or higher) to the post's YAML block.
+
+## Learn More
+
+For more knowledge about Jekyll posts, visit the [Jekyll Docs: Posts](https://jekyllrb.com/docs/posts/).
+
+
+
+

data/_sass/custom/styles.scss

@@ -0,0 +1 @@
+// put your custom layout here!

data/_sass/custom/variables.scss

@@ -0,0 +1 @@
+// put your custom variables here!

data/_sass/jekyll-theme-fica.scss

@@ -0,0 +1,8 @@
+@import 
+"themes/dark theme/theme-dark", 
+"custom/variables",
+"layouts/variables",
+"layouts/Google-fonts",
+"custom/styles",
+"layouts/layout",
+"layouts/base";

data/_sass/layouts/Google-fonts.scss

@@ -0,0 +1,139 @@
+@mixin material-icons {
+    font-family: 'Material Icons';
+    font-weight: normal;
+    font-style: normal;
+    font-size: 24px;
+    /* Preferred icon size */
+    display: inline-block;
+    line-height: 1;
+    text-transform: none;
+    letter-spacing: normal;
+    word-wrap: normal;
+    white-space: nowrap;
+    direction: ltr;
+    user-select: none;
+    -moz-user-select: none;
+    -khtml-user-select: none;
+    -webkit-user-select: none;
+    -o-user-select: none;
+
+    /* Support for all WebKit browsers. */
+    -webkit-font-smoothing: antialiased;
+    /* Support for Safari and Chrome. */
+    text-rendering: optimizeLegibility;
+
+    /* Support for Firefox. */
+    -moz-osx-font-smoothing: grayscale;
+
+    /* Support for IE. */
+    font-feature-settings: 'liga';
+}
+
+.material-icons {
+    @include material-icons();
+}
+
+/* Rules for sizing the icon. */
+.material-icons.md-18 {
+    font-size: 18px;
+}
+
+.material-icons.md-24 {
+    font-size: 24px;
+}
+
+.material-icons.md-36 {
+    font-size: 36px;
+}
+
+.material-icons.md-48 {
+    font-size: 48px;
+}
+
+/* Rules for using icons as black on a light background. */
+.material-icons.md-dark {
+    color: rgba(0, 0, 0, 0.54);
+}
+
+.material-icons.md-dark.md-inactive {
+    color: rgba(0, 0, 0, 0.26);
+}
+
+/* Rules for using icons as white on a dark background. */
+.material-icons.md-light {
+    color: rgba(255, 255, 255, 1);
+}
+
+.material-icons.md-light.md-inactive {
+    color: rgba(255, 255, 255, 0.3);
+}
+
+/* fallback */
+@font-face {
+    font-family: 'Material Icons';
+    font-style: normal;
+    font-weight: 400;
+    src: url(https://fonts.gstatic.com/s/materialicons/v128/flUhRq6tzZclQEJ-Vdg-IuiaDsNc.woff2) format('woff2');
+  }
+  /* fallback */
+  @font-face {
+    font-family: 'Material Icons Outlined';
+    font-style: normal;
+    font-weight: 400;
+    src: url(https://fonts.gstatic.com/s/materialiconsoutlined/v103/gok-H7zzDkdnRel8-DQ6KAXJ69wP1tGnf4ZGhUce.woff2) format('woff2');
+  }
+  /* fallback */
+  @font-face {
+    font-family: 'Material Icons Round';
+    font-style: normal;
+    font-weight: 400;
+    src: url(https://fonts.gstatic.com/s/materialiconsround/v102/LDItaoyNOAY6Uewc665JcIzCKsKc_M9flwmP.woff2) format('woff2');
+  }
+  
+  .material-icons {
+    font-family: 'Material Icons';
+    font-weight: normal;
+    font-style: normal;
+    font-size: 24px;
+    line-height: 1;
+    letter-spacing: normal;
+    text-transform: none;
+    display: inline-block;
+    white-space: nowrap;
+    word-wrap: normal;
+    direction: ltr;
+    -webkit-font-feature-settings: 'liga';
+    -webkit-font-smoothing: antialiased;
+  }
+  
+  .material-icons-outlined {
+    font-family: 'Material Icons Outlined';
+    font-weight: normal;
+    font-style: normal;
+    font-size: 24px;
+    line-height: 1;
+    letter-spacing: normal;
+    text-transform: none;
+    display: inline-block;
+    white-space: nowrap;
+    word-wrap: normal;
+    direction: ltr;
+    -webkit-font-feature-settings: 'liga';
+    -webkit-font-smoothing: antialiased;
+  }
+  
+  .material-icons-round {
+    font-family: 'Material Icons Round';
+    font-weight: normal;
+    font-style: normal;
+    font-size: 24px;
+    line-height: 1;
+    letter-spacing: normal;
+    text-transform: none;
+    display: inline-block;
+    white-space: nowrap;
+    word-wrap: normal;
+    direction: ltr;
+    -webkit-font-feature-settings: 'liga';
+    -webkit-font-smoothing: antialiased;
+  }