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.
- My oldest website, with various useful articles which are still found here and only here, is here: http://oldsite.electricrcaircraftguy.com/.
- See the navigation links in the top-left corner for more articles.
- 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:
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 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
- 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
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:
- .project
- .pydevproject
- Folders:
- .settings
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.
CNAME
- is the file which contains my DNS server domain name for my website, as configured online under repo --> Settings --> Pages --> Custom domain.- 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/orgit pull
that change down, depending on what you want to do.
- 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
_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 forcode-background-color
!_site/
- this is the output directory where the generated site is stored!
- sitemap.xml (find it in the
site/
dir above, too)- http://127.0.0.1:4001/sitemap.xml
- https://gabrielstaples.com/sitemap.xml
- 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.