/website

Primary LanguageHTMLOtherNOASSERTION

GDQuest.com

Website banner image

This is the complete source code for GDQuest.com. The website is entirely open-source.

Getting started

The website uses the static site engine hugo.

To test the site locally:

  1. Install hugo extended. On the GitHub releases page of hugo, look for an executable named hugo_extended_.... This version of Hugo includes tools to process pictures and SCSS code.
  2. Clone this repository.
  3. In your terminal, navigate to the repository's folder and run npm install. You need to have node.js installed for that.
  4. Once all node packages are installed, run hugo server --buildDrafts.

This will build the website locally, including draft pages, watch for any file changes, and make it accessible via a URL like localhost:1313.

Writing content

To create a new page, use the hugo new command. You need to give it a path to a new markdown file relative to the content/ directory.

hugo new tutorial/godot/3D/import-from-blender/index.md

The command above creates a new 3D Godot tutorial in content/tutorial/godot/3D/import-from-blender/. The file's name, index.md, is a special name for hugo that defines a page bundle. It links all other files in the directory, like images and videos, as resources of that new page. To define a new section, you want to name the file _index.md instead. Look into the content/ directory for some examples.

You can also use the --editor option to open the newly created file in a text editor:

hugo new tutorial/godot/3D/import-from-blender/index.md --editor $VISUAL

On Linux, you can use one of the special variables $EDITOR and $VISUAL to respectively open the new document in a terminal-based editor or a graphical application like Atom or Emacs.

Keeping the content as draft and publishing

Each document contains some metadata at the top, also called front-matter:

+++
title = "Importing 3D objects from Blender"
author = "nathan"
date = 2020-07-15

draft = true
+++

This metadata uses the TOML markup language. If the variable draft has the value true, the article is considered a draft and won't be published on the website. Remove the line draft = true for the article to be published.

Style guide

For SCSS code, we follow the RSCSS (Reasonable System for CSS Stylesheet Structure) style guide.

Note: some of the CSS code still doesn't follow the style guide. We're progressively moving code to that style-guide as we go.

Contributing

Help is always welcome!

Found a bug, a typo? Feel free to fix it or open a new issue for it. Also check out the existing issues.

Get in touch:

Licenses

The website uses two licenses for its content and its source code, respectively:

  • The website's content, that is to say, anything in the content/ directory, or images in the static/ directory, is available under the CC-By 4.0 license. If you reuse it, please attribute it to "GDQuest and contributors."
  • The website's source code, including the layouts/, the archetypes/, and the _src/ folder are under the MIT license.

For more information, see LICENSE.