layout	title	permalink
page	Readme	/readme/

This is the personal website of myself, Gabriel Staples.

It contains my own content and opinions and does not reflect opinions on behalf of any employer.

It can be viewed online here: https://electricrcaircraftguy.github.io/.
My other website is here: www.ElectricRCAircraftGuy.com.
1. Contact info.: https://www.electricrcaircraftguy.com/2013/01/contact-me.html
My oldest website, with various useful articles which are still found here and only here, is here: http://oldsite.electricrcaircraftguy.com/.
1. See the navigation links in the top-left corner for more articles.

Notes to self

Useful/quick links

Image formatting (centering, sizing, aligning, etc.)

See my answer here: Centering, sizing, and aligning images in markdown

Examples from my article here (markdown):

Single image:

Markdown

<p align="left" width="100%">
    <a href="https://github.com/ElectricRCAircraftGuy/ElectricRCAircraftGuy.github.io/assets/6842199/1e9c115e-5c5e-45dd-8b66-e260e0a0f984">
        <img width="33%" src="https://github.com/ElectricRCAircraftGuy/ElectricRCAircraftGuy.github.io/assets/6842199/1e9c115e-5c5e-45dd-8b66-e260e0a0f984"> 
    </a>
</p>

Result:

Multiple images:

Markdown

<p align="center" width="100%">
    <a href="https://github.com/ElectricRCAircraftGuy/ElectricRCAircraftGuy.github.io/assets/6842199/4169a450-f8a2-4bf0-8eee-333a26626093">
        <img width="32%" src="https://github.com/ElectricRCAircraftGuy/ElectricRCAircraftGuy.github.io/assets/6842199/4169a450-f8a2-4bf0-8eee-333a26626093"> 
    </a>
    <a href="https://github.com/ElectricRCAircraftGuy/ElectricRCAircraftGuy.github.io/assets/6842199/4ed833d3-e820-4c3b-a5ce-ed13842a97fa">
        <img width="32%" src="https://github.com/ElectricRCAircraftGuy/ElectricRCAircraftGuy.github.io/assets/6842199/4ed833d3-e820-4c3b-a5ce-ed13842a97fa"> 
    </a>
    <a href="https://github.com/ElectricRCAircraftGuy/ElectricRCAircraftGuy.github.io/assets/6842199/b8e98d62-2fee-4c10-a97d-d1b191b8504c">
        <img width="32%" src="https://github.com/ElectricRCAircraftGuy/ElectricRCAircraftGuy.github.io/assets/6842199/b8e98d62-2fee-4c10-a97d-d1b191b8504c"> 
    </a>
</p>

Result:

Site creation

This site was first created with the command jekyll new temp. See here: https://jekyllrb.com/docs/. Also, search the git log for where I documented using this command.

To build and test locally

# to install software
./run_upgrade_site.sh

# to build and preview the website!
./run_build_site.sh

# [my favorite] ...with unpublished pages, and drafts too:
./run_build_site.sh --drafts --unpublished

Then browse to ~~http://localhost:4000~~ http://localhost:4001.

See: https://jekyllrb.com/docs/.

UPDATE: I set port: 4001 in my _config.yml file, so browse here instead!: http://localhost:4001/. <== VIEW PREVIEW

GitHub Pages Help and References

Welcome_to_GitHub_Pages.md
GitHub Docs: Getting started with GitHub Pages
GitHub Flavored Markdown: Mastering Markdown
Cayman theme - see "Customizing" and other sections for how to customize your theme here

Eclipse

I'm using Eclipse simply as a text editor--not to build the project or anything. However, Eclipse has added a handful of files and directories as I've used it, as shown below.

Note: I have the "Eclipse Web Developer Tools" plugin installed, if that makes a difference. See my full Eclipse install instructions here.

To add my Jekyll website repo as a project in Eclipse, I did: File --> New --> Project --> Web --> Static Web Project --> Next. I made the project name my domain name: "gabrielstaples.com", manually set the file location to my GitHub repo on my local filesystem, and specified the website root folder to be the actual folder name of this repo on my local filesystem. This added the ".project" file and ".settings" folder below. At some point, I then opened up my "Gemfile" ruby file in the Python editor in Eclipse, since I didn't have a ruby editor in Eclipse and syntax highlighting for Python is close enough, and that caused the ".pydevproject" file to show up as well once I configured my Python environment for Eclipse, which it had me do because I used the Python editor.

Here are the Eclipse settings and project metadata and stuff, which Eclipse has added to this repo:

Files:
1. .project
2. .pydevproject
Folders:
1. .settings

Collections:

https://jekyllrb.com/docs/step-by-step/09-collections/

Themes:

See:

To locate a theme’s files on your computer: https://jekyllrb.com/docs/themes/#overriding-theme-defaults

Run bundle info --path followed by the name of the theme’s gem, e.g., bundle info --path minima for Jekyll’s default theme.

This returns the location of the gem-based theme files. For example, the Minima theme’s files might be located in /usr/local/lib/ruby/gems/2.6.0/gems/minima-2.5.1 on macOS.

Location of key files (for syntax, color, formatting, etc.)

CNAME - is the file which contains my DNS server domain name for my website, as configured online under repo --> Settings --> Pages --> Custom domain.
1. NB: if you change this value in GitHub online, GitHub will automatically create a commit for this change and push it to your repo! So, you'll have to git fetch and/or git pull that change down, depending on what you want to do.
_config.yml
_sass/minimal-mistakes/_base.scss
_sass/minimal-mistakes/_variables.scss
_sass/minimal-mistakes/_syntax.scss
assets/css/main.scss - I have some color overrides here, like for code-background-color!
_site/ - this is the output directory where the generated site is stored!

Important pages

sitemap.xml (find it in the site/ dir above, too)
1. http://127.0.0.1:4001/sitemap.xml
2. https://gabrielstaples.com/sitemap.xml
3. This helps Google crawl your page. Submit your sitemap to google here: https://search.google.com/search-console/sitemaps?resource_id=sc-domain%3Agabrielstaples.com. See my issue where I did this: Submit a site map to Google, to index my whole site #72.