vitrina 0.2.6 → 0.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92ad19de6e43ac4e4504ea39976afa354b0618a62228195bc8a64b1b4304e4e6
-  data.tar.gz: 135e40d594dd1cf47d781905f5022feb501b4f7b3b254bcaf70c70fcbfa5bad4
+  metadata.gz: 7bb20cd40db98a35ed50fe72937bd028c2a6983ce064a333005cc8f60153b216
+  data.tar.gz: cd72cebf380e97ffcb1fa9a39c4c611ceb098a5bd10298d958659b81d9d6aaa9
 SHA512:
-  metadata.gz: abf872026591b78c4176ee10515a40c5fc65b879184416b145fc62667129413bc88d451c9de927b9ecc3a907a2f0322d020041faaaae252852eaa8f6da38f1c7
-  data.tar.gz: 6628fefb8b5109535a108685c5d462938a75f481faba5da700cf5a714802f80d29052a2b40571cb42d48d0d05e37cdcd602252ae33a36d95b693a3ee086e5753
+  metadata.gz: 350df0bbbc95251e9bee9c9f1b1f544ad454242f71d6e22a838e32dc1d0984a61c43ba646e8ffe8fcbd71c0c1e210f70596e14dda0d0c14159a1c6d4c38449bf
+  data.tar.gz: 34901f643a2ab6d5b6fdc51e3fd50f1764dab80fe56855ec8f26545558ade0d6209602630bceb37a6491e8123695be31117e023866c0355c5e0e8819ca020138

data/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.2.8] - 2020-06-2
+
+### Added
+
+- Put troubleshooting into documentation
+
+### Changed
+
+- Contact layout now don't have a pre-defined contact form
+
 ## [0.2.6] - 2020-05-27
 
 ### Changed
@@ -51,7 +61,8 @@ All notable changes to this project will be documented in this file.
 - Unnecessary files from Jekyll build/serve
 
 
-[unreleased]: https://github.com/oAGoulart/vitrina/compare/v0.2.6...HEAD
+[unreleased]: https://github.com/oAGoulart/vitrina/compare/v0.2.8...HEAD
+[0.2.8]: https://github.com/oAGoulart/vitrina/releases/tag/v0.2.8
 [0.2.6]: https://github.com/oAGoulart/vitrina/releases/tag/v0.2.6
 [0.2.5]: https://github.com/oAGoulart/vitrina/releases/tag/v0.2.5
 [0.2.4]: https://github.com/oAGoulart/vitrina/releases/tag/v0.2.4

data/README.md

@@ -20,6 +20,7 @@ This theme was made with the purpose of being able to generate a site just by ed
   - [Resume page layout](#resume-page-layout)
   - [Structure content](#structure-content)
   - [Links](#links)
++ [Troubleshooting](#troubleshooting)
 + [Contributions](#contributions)
 
 # Usage
@@ -399,6 +400,99 @@ The links `_data/links.json` are used to generate contact information for the co
 ]
 ```
 
+# Troubleshooting
+
+These are some known issues that you may encouter:
+
+**Using this theme with GitHub Pages**
+---
+
+> GitHub Pages have strict rules for which Jekyll plugins can be used
+> with that being said [they do permit the use of any Jekyll themes publicly hosted on GitHub](https://github.blog/2017-11-29-use-any-theme-with-github-pages/)
+> to use this theme with GitHub pages add the `remote_theme` config to your `_config.json` with the `oAGoulart/vitrina` value
+
+```yaml
+remote_theme: oAGoulart/vitrina
+theme: vitrina
+```
+
+**Customizing this theme with SCSS**
+---
+
+> to change the theme looks you need to create a file called `assets/css/styles.scss`
+> then use the template below to add your own styles
+
+```scss
+---
+---
+@charset "utf-8";
+
+// this is the default values for color and font
+@import "customize.scss";
+// ... you can change those and put here your own ...
+// an example would be changing the primary color:
+// $primary: white;
+// that would make all elements that use that color white.
+// you could also use variables:
+// $primary: $white;
+
+// these are third party libraries
+@import "_bulma.scss";
+@import "_fork_awesome.scss";
+
+// these are the actual theme styles for the elements
+@import "elements.scss";
+@import "code.scss";
+```
+
+**ForkAwesome icons font not found**
+---
+
+> this issue is caused if you do not have the `fork-awesome` node package located under `node_modules/fork-awesome`
+> to fix this you should add `fork-awesome` as a dependency and install it using Yarn
+> also you can download and extract it inside that folder if you prefer
+
+```json
+"dependencies": {
+  "fork-awesome": "^1.1.7"
+}
+```
+
+**No repo name found. Specify using PAGES_REPO_NWO environment variables, 'repository' in your configuration, or set up an 'origin' git remote pointing to your github.com repository.**
+---
+
+> this is caused if you don't have a **GitHub** repository setup
+> it is necessary when using `github-pages` gem
+
+```rb
+gem 'github-pages', group: :jekyll_plugins
+```
+
+**Unknown tag 'seo' included in /_layouts/default.html**
+---
+
+> this issue is caused when the plugin `jekyll-seo-tag` is not specified at `_config.json`
+
+```yaml
+plugins:
+  - jekyll-seo-tag
+```
+
+**Blank page even when using layouts**
+---
+
+> generally caused by the lack of the `_data` folder and its files
+> also, the contact layout does not have a pre-defined contact form, take a look at `contact.md` for an example
+
+```
+.
+├── _data
+│   ├── general.json
+│   ├── home.json
+│   ├── links.json
+│   ├── resume.json
+```
+
 ---
 
 # Contributions

data/_layouts/contact.html

@@ -2,8 +2,6 @@
 layout: default
 ---
 
-{{ content }}
-
 <div class="contacts">
   <h1 class="title is-size-1 has-text-centered has-text-primary">{{ page.title }}</h1>
   <div class="section section-card">
@@ -26,54 +24,8 @@ layout: default
           </p> {% comment %} links {% endcomment %}
         </div>
         <div class="column has-text-dark">
-          <h1 class="is-size-2">Get in touch!</h1>
-          <p>Use the form below to send me a message.</p>
-          <form name="contact">
-            <div class="field">
-              <label class="label">Name</label>
-              <div class="control">
-                <input class="input" type="text" name="name" placeholder="e.g. Vitrina" required>
-              </div>
-            </div>
-            <div class="field">
-              <label class="label">Email</label>
-              <div class="control has-icons-left">
-                <input class="input" type="email" name="email" placeholder="e.g. vitrina@example.com" required>
-                <span class="icon is-small is-left">
-                  <i class="fa fa-envelope"></i>
-                </span>
-              </div>
-            </div>
-            <div class="field">
-              <label class="label">Subject</label>
-              <div class="control">
-                <input class="input" type="text" name="subject" placeholder="Message subject..." required>
-              </div>
-            </div>
-            <div class="field">
-              <label class="label">Message</label>
-              <div class="control">
-                <textarea class="textarea" name="message" placeholder="Message contents..." required></textarea>
-              </div>
-            </div>
-            <div class="field">
-              <div class="control">
-                <label class="checkbox">
-                  <input type="checkbox" name="terms" required>
-                  I agree to the <a href="#">terms and conditions</a>
-                </label>
-              </div>
-            </div>
-            <div class="field is-grouped">
-              <div class="control">
-                <input type="submit" class="button is-primary" value="Submit">
-              </div>
-              <div class="control">
-                <input type="reset" class="button is-link is-light" value="Cancel">
-              </div>
-            </div>
-          </div>
-        </form>
+          {{ content }}
+        </div>
       </div>
     </div>
   </div>

data/contact.md

@@ -2,3 +2,51 @@
 layout: contact
 title: Contact
 ---
+
+<h1 class="is-size-2">Get in touch!</h1>
+<p>Use the form below to send me a message.</p>
+<form name="contact">
+  <div class="field">
+    <label class="label">Name</label>
+    <div class="control">
+      <input class="input" type="text" name="name" placeholder="e.g. Vitrina" required>
+    </div>
+  </div>
+  <div class="field">
+    <label class="label">Email</label>
+    <div class="control has-icons-left">
+      <input class="input" type="email" name="email" placeholder="e.g. vitrina@example.com" required>
+      <span class="icon is-small is-left">
+        <i class="fa fa-envelope"></i>
+      </span>
+    </div>
+  </div>
+  <div class="field">
+    <label class="label">Subject</label>
+    <div class="control">
+      <input class="input" type="text" name="subject" placeholder="Message subject..." required>
+    </div>
+  </div>
+  <div class="field">
+    <label class="label">Message</label>
+    <div class="control">
+      <textarea class="textarea" name="message" placeholder="Message contents..." required></textarea>
+    </div>
+  </div>
+  <div class="field">
+    <div class="control">
+      <label class="checkbox">
+        <input type="checkbox" name="terms" required>
+          I agree to the <a href="#">terms and conditions</a>
+      </label>
+    </div>
+  </div>
+  <div class="field is-grouped">
+    <div class="control">
+      <input type="submit" class="button is-primary" value="Submit">
+    </div>
+    <div class="control">
+      <input type="reset" class="button is-link is-light" value="Cancel">
+    </div>
+  </div>
+</form>

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vitrina",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "A general purpose, configurable, Jekyll theme",
   "main": "index.html",
   "author": {

data/vitrina.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name          = 'vitrina'
-  s.version       = '0.2.6'
+  s.version       = '0.2.8'
   s.authors       = ['Augusto Goulart']
   s.email         = ['josegoulart.aluno@unipampa.edu.br']
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vitrina
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.2.8
 platform: ruby
 authors:
 - Augusto Goulart
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-27 00:00:00.000000000 Z
+date: 2020-06-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: github-pages