CloudBytes/dev> โ is a community that provides detail guides and how-tos๐ค explaining Cloud โโ, Python๐ and Computer Science๐ป๐งช concepts , designed for new ๐ adopters focused on making things work.
But most importantly making your experience of learning some complex topics from scratch a bit easier and hopefully more fun ๐๐๐.
You can open a new discussion here on this repository's Help / Discussion Community Forum to ask for help, or even provide suggestions / feedback.
You can contribute ๐ค๐ฝto this project in various ways, or simply reuse the repository for learning and building something yourself as outlined below.
If you want to post an article yourself , you can add a new file in the ๐๐ฝ content/snippet/
folder using the Add file
inline file editor option. Once done, submit a Pull Request (PR).
For correcting โ any typos โdo the same by using GitHub's inline editor and submit a PR.
Once the PR is merged, your article will be posted directly on the website using the Continuous Delivery (CD) pipeline in place.
If you know what you're doing ๐, feel free to fork the repository and add the guest post in the folder mentioned above. โ๐ฝ
To begin, fork the repository by clicking on the Fork
button on top right on this page. Depending upon your preferences, you can use one of the two below ๐๐ฝoptions.
You need to have VSCode, Git and Docker Desktop installed for this option, and nothing else.
- Open your VSCode and press
Ctrl + Shift + P
, - Then type
git clone
and press Enter. - Select
Clone from GitHub
and press enter - Choose your forked repository then save it on your system
- Open the cloned repository in VSCode
- After a few seconds, you should get a prompt to reopen the repository in Container. Choose
Reopen in Container
This will create a Docker Container with Python, NodeJS and Firebase CLI installed, add all of the cloned files in that and install all the dependencies defined under requirements.txt
No need for any virtual environment of conflicting packages.
This repository comes packaged with Firebase Hosting Emulator tool that can be used to serve the website locally.
Open the terminal in VSCode and run the below to continously regenerate the output
make dev
Open the URL localhost:8080
in your browser.
The repository has the following structure:
.devcontainer
: VSCode Devcontainer Dockerfile for easy configuration.github/workflows
: Contains the script for automated deployment using this custom action.app/content
: Where the content residesplugins
: Custom plugins to add additional featuresdesign
: Themes for the website. The current version is nicknamedalexis
.
Additionally, the following files are of importance
app/pelicanconf.py
: The Pelican ๐ฆข configuration being used by the website used for local developmentMakefile
: An alternate method to generate website without the need for installation of other toolsapp/publishconf.py
: Configuration for publishing the website used for final website generationrequirements.txt
: All the python dependencies usedtasks.py
: Pre-configured build tasks that can be customised as per needaddons.py
: Hook to run any post-build actions not covered by Pelican plugins