ALiAS Blog

This repository holds the source code and related content of the official blog for Amity Linux Assitance Sapience

ALiAS is a platform for upcoming developers for finding exposure by meeting the people working in related industries, learning various languages and becoming a better developer.

The website has been created using hugo and the theme used is hugo-nederburg-theme.

This website is currently under construction and all your inputs are highly appreciated.

Any writers willing to add your own thoughts to the blog can refer to the "instructions for Writer" section to learn about posting on the blog.
Any developers interested in the development of the website can refer to the "Instructions for Developers" for help on how to contribute.
Anyone willing to contribute and help in this project can refer to the Issues Section of the repository and take a look at issues which they can help solve.
First time Git/Github users can refer to the "First time Contributors" section at the end of the document for guides and help on how to use git and Github and start contributing.
To be involved in the ongoing discussions please join our Telegram Group.

Hugo installation and Setup

Windows

Visit the link Hugo Releases and download the latest release of hugo for Windows.(Hugo 0.53 at the time of writing this).
Create a directory named Hugo where you want your program to be installed.
Create a subdirectory bin and extract the contents of the downloaded file in that.
For CLI users, navigate to the location of your hugo.exe file, then add hugo.exe to PATH using the command set PATH=%PATH%...\Hugo\bin where ... is the path to the Hugo directory.

For non-CLI users:

For Widows 10:

Search and Open Advanced System Settings.
Click on the Environment Variables… button on the bottom.
In the User variables section, find the row that starts with PATH.
Double-click on PATH.
Click the New… button.
Type in the folder where hugo.exe was extracted. The PATH entry should be the folder where Hugo lives and not the binary.

For Windows 7 and 8.x users:

Windows 7 and 8.1 do not include the easy path editor included in Windows 10, so non-technical users on those platforms are advised to install a free third-party path editor like Windows Environment Variables Editor or Path Editor.

MacOS

Install the Homebrew utility using the command /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" in macOS Terminal prompt.
Install Hugo using brew install hugo.
You can check if Hugo runs corretly using hugo version.

Linux

In any Linux Distribution that supports snap (which can be checked here), hugo can be installed using snap install hugo --channel=extended.

Debian and Ubuntu

Hugo can be installed from official Hugo debian package using sudo apt-get install hugo.

Arch Linux

Hugo can be installed from the Arch Linux community repository using sudo pacman -Syu hugo.

Fedora, Red Hat and CentOS

Hugo can be installed from official fedora package for hugo using sudo dnf install hugo.

Souls

Hugo can be installed from souls official repository using sudo eopkg install hugo.

OpenBSD

Hugo can be installed from its package using doas pkg_add hugo.

Hugo is now installed in your sytem and is ready to use

Website Setup

clone this repository.
Open Terminal or your preferred CLI and navigate to the location of the repository.
Use the command hugo server to start a local sever of the website on your machine.

The website will be available on http://localhost:1313/

Instrucitons for Developers:

Git is required to contribute to the website and Hugo is required to run the site and test it on a local server.

For hugo installation and usage instructions, refer to Hugo installation and setup Section.
Fork the repository to your Github account.
Clone the repository to your machine by using the command git clone https://github.com/rohanvtk/ALiAS_Blog.git
Make the changes locally and push them to your own repository.
Review the changes in your repository and submit a pull request.

Instruction for Writers:

The Language used for blog posts is Markdown

Fork and clone the repository. For instructions on doing that, please refer to instructions for developers
Create you work file in /content/post, see existing files as an example.
To run a local copy of the website, open the command prompt or your preferred CLI, change the directory to the address of the repository and use the command hugo server if you have hugo installed. For instruction on Hugo installation and use, refer to Hugo installation and setup Section.
Submit a pull request to submit your work.

First time contributors:

For a begineers guide on using Github, Visit Hello World-Github.
For a guide to set up git for the first time, visit Setting up Git.
For a begineers git guide, visit git-a simple guide.
For a detailed Git guide, you can read the book pro git.

Help and other Documentation:

For hugo documentation, click here.
For markdown cheat sheet, click here.
For details about the theme, click here.
Getting started with ALiAS: Getting Started

hastagAB / ALiAS_Blog