Awesome-discoveries

This repository hosts a curated list of useful, inspiring, fascinating, and eclectic discoveries and thoughts I made and produced during my readings, experiments and job decisions making being a startup advisor and the CTO of a world leading drone company. Some topics are highly technical; some are not.

This repository uses the hugo static site generator along with the "Book" template. The result is hosted on AWS Amplify.

To get a hugo static site generation template working with AWS Amplify please refer to my other repository hugo-book-amplify-template.

The building results of this repository is automatically published on hervenivon.io.

🛠 Development

Once you have configured the Amplify Console deployment process from the previous paragraph, every time you push or you do a pull request, the Amplify Console will trigger a build and deployment pipeline.

If you want to see locally what is your impact on your markdown content change, please execute the following in your favorite terminal (with the Hugo Pre requisites applied) and the git submodule updated: git submodule update --recursive --init

hugo server -D

It will compiled your static web site content, include draft in process and launch a live reloading local server serving your content.

⚙️ Hugo's theme configuration

Please refer to Book configuration paragraph.

🏗 Deployment with the AWS Amplify Console

This repository uses the AWS Amplify Console to deploy itself as a static website. The AWS Amplify Console builds it and provision a place to store and distribute it globally. AWS Amplify Console also provides helpful capabilities to simplify both the web site lifecycle and enforce best practices.

Under the hood, the AWS Amplify Console leverages Amazon S3 static hosting and Amazon CloudFront to distribute your assets. The AWS Amplify Console automatically handle cache invalidation each time you push a new version of your web site to your repository.

✅ Step by steps instructions:

1. Launch the The AWS Amplify Console dashboard

2. Click Get Started under Deploy with Amplify Console

3. Select the Repository service provider and select Next

   • As this repository is on GitHub, and you have likely forked it, you'll need to select github and to authorize AWS Amplify to access your GitHub account

4. From the dropdown select the Repository and Branch of your fork

   

5. On the "Configure build settings" page leave all the defaults and select Next

   • AWS Amplify should have detected the amplify.yml settings.

   

6. On the "Review" page select Save and deploy

   The process takes a couple of minutes for Amplify Console to create the necessary resources and to deploy your code.

   

7. Once completed, click on the site image to open your static site in your browser.

   

If you click on the link for Master you'll see various pieces of information about your website deployment, including sample renderings on various platforms:

Technical details 🛠

This repository is supported by Python scripts, here are some details that might be helpful.

Pre-requisites

Conda must be installed.

Then create an environment dedicated to this project:

1. Create conda environment: $> conda create --name ad python=3.7 ipython
2. Activate conda environment: $> conda activate ad
3. Install other requirements: $> pip install -r requirements.txt

url checker

In order to verify that referenced urls are valid please execute the following in the conda environment at the repository root directory:

./scripts/check-urls.py

🤝 Participate

If you have any suggestion, or want more details, do not hesitate to reach out!