Skip to content

Commit e4fad06

Browse files
Update about page and simplify footer
1 parent b2b6d05 commit e4fad06

File tree

4 files changed

+17
-88
lines changed

4 files changed

+17
-88
lines changed

_config.yml

Lines changed: 3 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,9 @@ title: "STM32-base project"
66
logo: "/assets/img/logos/STM32-base_logo_no_text_transparent.png"
77
author: "Thomas Gravekamp"
88
description: >
9-
The STM32-base project provides its users with a simple and easy to use base
10-
project for working with STM32 microcontrollers.
9+
The STM32-base project is meant for students and hobbyists. The goal of the
10+
STM32-base project is to provide a simple and easy to use base project for
11+
working with STM32 microcontrollers.
1112
1213
mainMenu:
1314
- name: "Home"
@@ -28,38 +29,3 @@ mainMenu:
2829
- name: "Github"
2930
url: "https://github.com/STM32-base"
3031
external: true
31-
32-
footerMenu:
33-
- name: "Home"
34-
url: ""
35-
external: false
36-
- name: "About"
37-
url: "general/about"
38-
external: false
39-
- name: "Privacy Policy"
40-
url: "general/privacy-policy"
41-
external: false
42-
- name: "License"
43-
url: "general/license"
44-
external: false
45-
- name: "Blue Pill board"
46-
url: "boards/STM32F103C8T6-Blue-Pill"
47-
external: false
48-
- name: "Black Pill board"
49-
url: "boards/STM32F103C8T6-Black-Pill"
50-
external: false
51-
- name: "Getting started with STM32"
52-
url: "guides/getting-started"
53-
external: false
54-
55-
socialsMenu:
56-
- icon: "fas fa-home"
57-
url: "https://stm32-base.org/"
58-
- icon: "fab fa-github"
59-
url: "https://github.com/STM32-base"
60-
61-
footer:
62-
- >
63-
<p>This website is hosted on <a href="https://pages.github.com/">Github pages</a>.
64-
The STM32-base project is <i>in no way</i> affiliated with <a href="https://www.st.com/">STMicroelectronics</a>.</p>
65-
<p><a href="https://jeffhuang.com/designed_to_last/">This page was designed to last</a>.</p>

_layouts/base.html

Lines changed: 2 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -53,25 +53,12 @@
5353
<div class="wrapper">
5454
<div class="footer-columns">
5555
<div class="footer-column">
56-
<nav>
57-
<menu class="footer-menu">
58-
{%- for item in footer -%}
59-
<li><a href="{% if item.external == false %}{{ site.url }}/{% endif %}{{ item.url }}">{{ item.name }}</a></li>
60-
{%- endfor -%}
61-
</menu>
62-
</nav>
56+
<p>This is the <a href="https://stm32-base.org">STM32-base project website</a>. Learn more <a href="https://stm32-base.org/general/about">about</a> the STM32-base project or check out this project on <a href="https://github.com/STM32-base">Github</a>. The STM32-base project is <i>in no way</i> affiliated with <a href="https://www.st.com">STMicroelectronics</a>.</p>
6357
</div>
6458
<div class="footer-column">
65-
{{ site.footer }}
59+
<p>This website is hosted on <a href="https://pages.github.com/">Github Pages</a>. This page is <a href="https://jeffhuang.com/designed_to_last/">designed to last</a>. Check out which <a href="https://stm32-base.org/general/license">licenses</a> apply to this website and its contents. Check out the <a href="https://stm32-base.org/general/privacy-policy">Privacy policy</a>.</p>
6660
</div>
6761
</div>
68-
<div class="social-icons">
69-
<ul>
70-
{%- for item in socials -%}
71-
<li><a href="{{ item.url }}"><i class="{{ item.icon }}"></i></a></li>
72-
{%- endfor -%}
73-
</ul>
74-
</div>
7562
</div>
7663
</footer>
7764
<script src="{{ '/assets/js/scale.fix.js' | relative_url }}"></script>

_sass/layout.scss

Lines changed: 0 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -161,34 +161,6 @@ body {
161161
margin: 0;
162162
}
163163

164-
.social-icons ul {
165-
list-style: none;
166-
padding: 0;
167-
margin: 0 auto;
168-
display: table;
169-
170-
&:after {
171-
content: "";
172-
clear: both;
173-
}
174-
175-
li {
176-
float: left;
177-
padding: 0;
178-
}
179-
180-
a {
181-
display: block;
182-
margin: .25rem;
183-
padding: .75rem;
184-
text-align: center;
185-
width: 1.5rem;
186-
height: 1.5rem;
187-
line-height: 1.5rem;
188-
border: $border-style-default;
189-
}
190-
}
191-
192164
@media screen and (max-width: $screen-width-threshold) {
193165
body {
194166
word-wrap: break-word;

general/about.md

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,25 @@
11
---
2-
title: "About this project"
2+
title: "About"
33
---
44

55
# {{ page.title }}
66

7-
The purpose of the STM32-base project is to provide a simple and easy to use base project for working with STM32 microcontrollers. This project is intended for those who want to know how everything they're using works.
7+
The [STM32-base project]({{ site.url }}) is mostly meant for students and hobbyists. The goal of the STM32-base project is to provide a simple and easy to use base project for learning about and experimenting with [STM32 microcontrollers](https://www.st.com/en/microcontrollers-microprocessors/stm32-32-bit-arm-cortex-mcus.html).
88

9-
Most tutorials, guides, and projects are focussed on getting you started as fast as possible. They are written with the assumption that the make files, linker scripts, startup code, and CMSIS are already present and consider them black boxes.
9+
Another big part of the STM32-base project is the [development board section]({{ site.url }}/boards/) on this website. That section almost became a project in itself. It became increasingly important to the STM32 community after the stm32duino wiki went offline.
1010

11-
A lot of important and interesting information is left out of tutorials and guides because of that assumption. When working with these microcontrollers, I _do_ want to know how everything works. That was the main reason I started this project.
11+
## How it started
1212

13-
I had no experience with bare-metal programming microcontrollers prior to this project. I took a deep dive into the world of programming STM32 microcontrollers. As I learned more and more, I felt the need for some place to document my findings.
13+
I first read about the Blue Pill on a [local hackerspace's website](https://revspace.nl/STM32). Someone had written a guide on how to get started with stm32duino and the Blue Pill. I soon ordered some [Blue Pill boards]({{ site.url }}/boards/STM32F103C8T6-Blue-Pill) after I read more about the features of the [STM32F103C8T6 microcontroller](https://www.st.com/content/st_com/en/products/microcontrollers-microprocessors/stm32-32-bit-arm-cortex-mcus/stm32-mainstream-mcus/stm32f1-series/stm32f103/stm32f103c8.html).
1414

15-
That was the moment this project started. This project merely scratches the surface of programming STM32 microcontrollers and is nowhere near complete. There is so much to more learn and discover.
15+
I wanted to experiment with the CAN bus controller on these microcontrollers. However, when using an Arduino bootloader meant that the USB controller was already in use. The problem here is that the USB controller and the CAN bus controller share a dedicated SRAM memory on that device. I then decided to look into bare-metal programming STM32 microcontrollers. How hard could it be?
1616

17-
I hope that this project is helpful for those who want to start working with STM32 microcontrollers and feel the same need to know how everything works. To learn more about me and the things I do, visit my website at [thomas-gravekamp.nl](https://thomas-gravekamp.nl).
17+
I started looking for tutorials which would explain to me how to set up a toolchain, and more importantly, why you need things like linker scripts and startup code and how they work. Most tutorials, however, were focussed on getting you started as fast as possible. They were written with the assumption that the makefiles, linker scripts, startup code, and CMSIS are already present and considered them black boxes.
1818

19-
I am in no way affiliated with [STMicroelectronics](https://www.st.com). This is just a personal hobby project.
19+
I don't like that. I _do_ want to know how everything works. That's why I started this project. I started gathering information from many sources and put it all together. And still, this project is not nearly as far as I would like it to be. But progress is made every now and then, and that is the most important thing.
20+
21+
I hope that this project helps out those who currently are where I was when I started this project. To learn more about me and the things I do, visit my website at [thomas-gravekamp.nl](https://thomas-gravekamp.nl).
22+
23+
I am in _no way affiliated_ with [STMicroelectronics](https://www.st.com). This is just a personal project.
2024

2125
\- _Thomas Gravekamp_

0 commit comments

Comments
 (0)