/Digital-Future

Digital :rocket: Future Website

Primary LanguageCSSMIT LicenseMIT

Digital 🚀 Future Website

This repository is the Digital 🚀 Future Community Page that is powered by JekyllJekyll icon, Amp Project Jekyll icon and GitHub Pages :octocat: with the incredible Hanuman theme.

Digital-Future

Creating Posts and News 📝

In Digital-Future we give the opportunity that everyone can upload any posts or news. Before uploading anything, it needs to be reviewed by other administrators to determine if the publication doesn't brake any rule of content or it have something inappropriate.

Rules of publications 👮

These are some rules that all posts or news need to accomplish:

  • All the content is truthful and extracted from trusty sources (giving the appropriate credit to the source). 🔖

Writing post's ✒️

Since the Website is made with Jekyll and Amp, you can create your post using markdown. Here you can find a great guide about writing with markdown ✏️, but since it uses Amp you would need to see the Amp documentation in case of using responsive media like images, videos, etc.

Example:

Images: <amp-img src="welcome.jpg" alt="Welcome" height="400" width="800"></amp-img>

Videos: <amp-youtube data-videoid="mGENRKrdoGY" layout="responsive" width="480" height="270"></amp-youtube>

You can see other posts already published in _posts folder, or see the examples and tutorials in the _howto folder to have an idea.

Remember, if you have any question or something, feel free to open an issue.

Using AMP Components

Some AMP components require you to specify external scripts before using them. You can specify these scripts in the head.html file in the includes directory after the already imported scripts and then use these components in any post.

Here are some nice tutorials and recommendations of how to write a post the right way and make it reach more people.

If you want to know more about the syntax of writing posts, you can read the Jekyll posts documentation 📖.

Post header

All the posts need to have a header where you specify the info of the post. This needs to be at the top of your post.md document

---
layout: post
cover: assets/posts/2018-02-23-Google_anuncia_ARCore1.0/cover.png
title: Google Anuncia ARCore 1.0 y Google Lens
date: 2018-02-23T13:09:00.000Z
tags: Google VR AR
author: José Manuel Gama
---
  • It takes the basic layout of a post that gives it the style.
  • The cover is the image that is going to be used for the publication cover (this need to be in your images folder of the post, you can see how this work in the Storing files section).
  • The title is going to be show above the cover with white letters.
  • The publication date.
  • Some tags that relate the post with others.
  • The author that wrote the post.

Naming documents

When you write a post or new, the name of the document need to be like:

YYYY-MM-DD-name_of_the_post.md
-----------------------------------
Example:
2018-02-26-writing_my_first_post.md

Storing files

The document with the .md file where you write the post, need to by stored in the _posts folder 📂.

If you are using local images, you need to create a new folder with the name of your post inside assets/posts. Then you can save all your images in your folder.

Example: saving the (cover.png, imagen1.jpg, imagen2.jpg)

assets
    |
    posts
        | ****this is the folder you create with the name of your post****
        2018-02-26-writing_my_first_post
            | ****here is where you store your images****
            cover.png
            imagen1.jpg
            imagen2.jpg