Visit Page
4
1
Fork
You've already forked pages
2

zola: Initial bulk port of the page content to zola. #73

Merged
esden merged 42 commits from zola-migration into main 2026年06月21日 00:15:17 +02:00
Owner
Copy link

Thank you @northernpaws for your amazing work putting together the new
foundation for the website including the theme.

Still a bunch of work is needed to polish it all out. But it is a good start.

Here is a running TODO list:

  • The "edit page with codeberg" link on the front page is hidden behind the header banner
    Screenshot 2026年05月10日 at 13.08.36
  • blog index formatting needs improvement
  • blog section should probably have the first article listed on the first page
    Screenshot 2026年05月10日 at 13.08.44
  • blog order is reversed ("previous" leads to the newer article)
  • we are missing some shortcodes
    • an asciinema shortcode (for embedding asciinema recordings)
    • a youtube embed shortcode
    • (削除) note and warning blocks (with associated color scheme) (削除ここまで) the container shortcode seems to be for that purpose, but it can't have markdown inside the container :slight_frown: done (esden)
    • Style warning container shortcode with a distinct background color
    • Style todo container shortcode with a distinct background color
  • Ability to create platform specific tabbed sections. Aka "do this for windows", "do this for linux". Link to current docs for reference.
  • I am not sure if we have favicon set up properly yet.
  • organize icons on the front page so they are next to each other
    Screenshot 2026年05月10日 at 13.08.29
  • Provide a way to organize pictures horizontally. See supported hardware section...
    Screenshot 2026年05月10日 at 13.09.08
  • Code syntax highlight blocks are a bit wonky. 😄
  • Pinout diagrams are not generated or included in the new page yet.
  • Add the project logo to the sidebar.
Thank you @northernpaws for your amazing work putting together the new foundation for the website including the theme. Still a bunch of work is needed to polish it all out. But it is a good start. Here is a running TODO list: * [x] The "edit page with codeberg" link on the front page is hidden behind the header banner ![Screenshot 2026年05月10日 at 13.08.36](/attachments/b1ff4ac9-7fea-431c-9ace-1af884cde239) * [x] blog index formatting needs improvement * [x] blog section should probably have the first article listed on the first page ![Screenshot 2026年05月10日 at 13.08.44](/attachments/16a9c826-a8e8-4314-944d-cb5b988a6e32) * [x] blog order is reversed ("previous" leads to the newer article) * we are missing some shortcodes * [x] an asciinema shortcode (for embedding asciinema recordings) * [x] a youtube embed shortcode * [x] ~~note and warning blocks (with associated color scheme)~~ the container shortcode seems to be for that purpose, but it can't have markdown inside the container :slight_frown: **done** (esden) * [x] Style warning container shortcode with a distinct background color * [x] Style todo container shortcode with a distinct background color * [x] Ability to create platform specific tabbed sections. Aka "do this for windows", "do this for linux". [Link to current docs for reference](https://black-magic.org/upgrade.html#update-using-bmputil). * [x] I am not sure if we have favicon set up properly yet. * [x] organize icons on the front page so they are next to each other ![Screenshot 2026年05月10日 at 13.08.29](/attachments/adb8ef5c-a052-46ab-986a-723f609d14a6) * [x] Provide a way to organize pictures horizontally. See supported hardware section... ![Screenshot 2026年05月10日 at 13.09.08](/attachments/a0f368cd-9b80-4561-bef6-8a12d754b115) * [x] Code syntax highlight blocks are a bit wonky. :smile: * [x] Pinout diagrams are not generated or included in the new page yet. * [x] Add the project logo to the sidebar. 
Thank you @northernpaws for your amazing work putting together the new
foundation for the website including the theme.
The shortcode needed also to get markdown parsed in the body, this patch adds it.
Now the python project does not depend on anything but the stuff needed
for the pinout diagram generation.
The makefile will use uv to sync the packages, generate the pinout
diagrams and then run the zola serve process.
Author
Owner
Copy link

I think the only remaining thing is to figure out what we do with project news section on the frontpage. Otherwise it is pretty much ready to go live. :) Great job @northernpaws :D

I think the only remaining thing is to figure out what we do with project news section on the frontpage. Otherwise it is pretty much ready to go live. :) Great job @northernpaws :D
esden changed title from (削除) WIP: zola: Initial bulk port of the page content to zola. (削除ここまで) to zola: Initial bulk port of the page content to zola. 2026年06月01日 05:45:32 +02:00
dragonmux requested changes 2026年06月02日 06:07:13 +02:00
Dismissed
dragonmux left a comment
Copy link

Spotted a couple of fairly small things - with them addressed we'll be happy to approve.

Spotted a couple of fairly small things - with them addressed we'll be happy to approve.
@ -0,0 +1,91 @@
+++
title = "We moved to Codeberg"
#date = April 08, 2026
#author= esden

This looks a little odd that it has a Unicode character inserted here (\u00a0) between author and = but this doesn't happen on any other pages - was this intentional?

This looks a little odd that it has a Unicode character inserted here (\u00a0) between `author` and `=` but this doesn't happen on any other pages - was this intentional?
Author
Owner
Copy link

done

done
esden marked this conversation as resolved
@ -0,0 +59,4 @@
(or a shortening such as `mon debug en`) from in GDB after connecting in to your BMP as normal. Alternatively, you
can set up Black Magic Inception, detailed in the following section.
## Black Magic Debugging

This should either be Black Magic Debug Debugging, or be left as was as the name of the feature is Black Magic Inception whereby one uses a BMP to debug a BMP.

This should either be `Black Magic Debug Debugging`, or be left as was as the name of the feature is `Black Magic Inception` whereby one uses a BMP to debug a BMP.
Author
Owner
Copy link

Ok changed.

Ok changed.
esden marked this conversation as resolved
@ -0,0 +47,4 @@
For older Windows versions (Windows 7 and older), you will be prompted to install a driver. You can download
the [driver .inf](https://codeberg.org/blackmagic-debug/blackmagic/src/main/driver) from the repository.
{% end %}
</br>

Rather than an explicit <br/>, can this not be done by leaving a blank line or two in the Markdown?

Rather than an explicit `<br/>`, can this not be done by leaving a blank line or two in the Markdown?
Author
Owner
Copy link

Unfortunately two new lines do not have the same effect as <br/>. Right now to get a separation of those two notes we need to use <br/>. I don't see another way to do it.

Unfortunately two new lines do not have the same effect as `<br/>`. Right now to get a separation of those two notes we need to use `<br/>`. I don't see another way to do it.

Ah, shame - something to dig into later if/when we want to try and clean up HTML markup showing up in the content so we're more rendering output agnostic again in the future.

Ah, shame - something to dig into later if/when we want to try and clean up HTML markup showing up in the content so we're more rendering output agnostic again in the future.
dragonmux marked this conversation as resolved
@ -0,0 +21,4 @@
For these reasons, the preferred way of OTP programming is done from _hosted_ Blackmagic.
## Hosted OTP programming

"hosted" here means BMDA - this should be adjusted to something like "Programming OTP with BMDA"

"hosted" here means BMDA - this should be adjusted to something like "Programming OTP with BMDA"
Author
Owner
Copy link

Adjusted.

Adjusted.
esden marked this conversation as resolved
@ -0,0 +3,4 @@
weight = 360
+++
[PlatformIO](https://platformio.org/?utm_source=codeberg&utm_medium=blackmagic) is an open source ecosystem for IoT development with the cross-platform build system, library manager and **full support for Black Magic Probe**. It works on the popular host OS: macOS, Windows, Linux 32/64, Linux ARM (like Raspberry Pi, BeagleBone, CubieBoard).

Do we need to have Urchin Tracker links here? This looks like the original author of this put them in because they didn't realise.. but we should strip them while we're here as they serve no useful purpose to use or the reader.

Do we need to have Urchin Tracker links here? This looks like the original author of this put them in because they didn't realise.. but we should strip them while we're here as they serve no useful purpose to use or the reader.
Author
Owner
Copy link

Ok. I thought it is useful to show them they are getting traffic from us. But I guess they can see that from referrer anyways. I removed them.

Ok. I thought it is useful to show them they are getting traffic from us. But I guess they can see that from referrer anyways. I removed them.
esden marked this conversation as resolved
@ -0,0 +7,4 @@
Choose a topic from the menu on the left.
WARNING: This is legacy documentation for V1 firmware.

Suggest V1 -> v1.x as it's the documentation for the entire release series.

Suggest `V1` -> `v1.x` as it's the documentation for the entire release series.
Author
Owner
Copy link

Corrected.

Corrected.
esden marked this conversation as resolved
northernpaws left a comment
Copy link

Looks pretty good to me, expect the logo in the navbar on the homepage is oddly wrapping now instead of inline and a problem with the home page title rendering. Will look into that!

Looks pretty good to me, expect the logo in the navbar on the homepage is oddly wrapping now instead of inline and a problem with the home page title rendering. Will look into that!
Corrected the remaining WARNING block to use the GH notation.
dragonmux approved these changes 2026年06月03日 02:36:50 +02:00
Dismissed
dragonmux left a comment
Copy link

LGTM from our perspective - approving.

LGTM from our perspective - approving.
northernpaws dismissed dragonmux's review 2026年06月11日 18:19:28 +02:00
Reason:

New commits pushed, approval review dismissed automatically according to repository settings

northernpaws left a comment
Copy link

Looks good to me!

Looks good to me!
esden deleted branch zola-migration 2026年06月21日 00:15:22 +02:00
Sign in to join this conversation.
No reviewers
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
3 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
blackmagic-debug/pages!73
Reference in a new issue
blackmagic-debug/pages
No description provided.
Delete branch "zola-migration"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?