Hello, internet!
This repository has been archived on 2023-04-23. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
KorbsStudio d35b40a09e Update footer.html 2022-04-13 20:59:12 -04:00
.github Create FUNDING.yml 2021-12-09 19:15:47 -05:00
_includes Update footer.html 2022-04-13 20:59:12 -04:00
_layouts Hello, first article! 2021-12-10 00:05:45 -05:00
_pages/categories update 2022-04-13 20:51:31 -04:00
_posts/electron Hello, new article! 2021-12-10 02:54:11 -05:00
assets Update style.css 2022-04-13 20:53:18 -04:00
.gitignore Hello, internet! 2021-12-07 21:45:10 -05:00
404.html Update 404 error 2021-12-09 16:30:38 -05:00
CODE_OF_CONDUCT.md Use domain address 2021-12-10 01:37:04 -05:00
CONTRIBUTING.md update 2021-12-08 23:42:38 -05:00
Gemfile Hello, internet! 2021-12-09 01:51:11 -05:00
Gemfile.lock Hello, internet! 2021-12-09 01:51:11 -05:00
LICENSE Hello, internet! 2021-12-09 01:51:11 -05:00
README.md Update README.md 2022-01-19 18:29:17 -05:00
_config.yml update 2022-04-13 20:51:31 -04:00
index.markdown Hello, internet! 2021-12-09 01:51:11 -05:00

userverge

Creating a New Article

Want to help contribute to the userverge? Write or update an article!

🛡️ Requirements

  • The communication must be clear and well explained for the user to understand
  • Fact check and make sure the information you're providing is accurate
  • Good grammar
  • Valid syntax
  • Proper metadata
  • Valid links and up to date

✍️ Creating an Article

By following the file structure, create a .md file under the correct category. As an example, if you were to create an article that explains on how to do something in Python, the file would be created like _posts/python/2021-09-12-title-of-article.md. You're required to add the date at the beginning of the file name, YYYY-DD-MM. These dates are used to show when the article was last updated, to allow users to know if the article is up to date.

Then start writing the article in Markdown. Writing in Markdown is very easy to do, if you need help understanding how to do certain task like creating a link, inserting an image, creating a list look here.

📃 Metadata

Make sure the metadata is setup properly, this is usually at the top of every article. It should look like this:

---
layout: post
title:  "Title of Article"
categories: ReactNative
permalink: /reactnative/ios/headerBlurEffect/
---

Author

For author, just replace octocat with your GitHub username.

<div class="authors">
    <p>Author: <a href="#" target="_blank">{% avatar Octocat %} Octocat</a></p>
</div>

Make this is placed at the between the metadata and article.

The {% avatar Octocat %} variable will grab your GitHub avatar to use as your profile picture on userverge, thanks to the jekyll-avatar plugin.

📢 Publishing

Create a pull request on this repo and title it like this "New Post: Name of Article" or if you're editing an article to maybe improve or fix a typo, title it like "Edit: Name of Existing Article".

Building

If you're interested in learning on how to build userverge locally, maybe to preview that your article does show up properly, just follow the instructions below.

Since userverge is powered by Jekyll, you'll need to install Ruby for your operating system.

Installing Ruby on Linux

Debian/Ubuntu:

sudo apt-get install ruby-full build-essential zlib1g-dev
gem install jekyll bundler
bundle install

Fedora/RedHat:

sudo dnf install make automake gcc gcc-c++ kernel-devel ruby-devel
gem install jekyll bundler
bundle install

Building and Locally Hosting

To run a localhost server, run:

bundle exec jekyll serve

After using bundle exec jekyll serve, try going to http://localhost:4000/ in your preferred web browser.

If you're unable to get Ruby installed or the serve command working, you can always resort to building it on other platforms like GitHub Pages, Cloudflare Pages, or Netlify.