Posts by mtakagishi
Adding AGENTS.md to an Existing Sphinx + ablog Technical Note
- 2026/05/10
As I have been using Codex more often to edit this technical note, I decided to collect the repository-specific working rules in AGENTS.md.
Steps to rebuild a broken WSL environment after using Rancher
- 2025/07/05
Due to the fact that I had installed Rancher on Windows in the past, wsl install did not work properly and I was unable to use WSL2. This time, I was able to completely initialize and rebuild the WSL environment, so I will record the steps.
ChatGPT “Project” feature practice notes
- 2025/06/04
This page organizes how to incorporate the ChatGPT-4o/o3 series “project” function into a problem-solving workflow centered on Python development. This is a memo that serves as both a personal memo and a blog article, from an overview of functions to model selection, handling of large repositories, limitations and countermeasures.
Consideration of introducing Markdown and decision of continuing reStructuredText
- 2025/06/03
In Sphinx + ablog, we considered writing articles in Markdown instead of reStructuredText.
Record of trying to find an alternative to blockdiag but giving up
- 2025/06/02
Regarding sphinxcontrib.blockdiag, the dependency on Pillow 9.5 was a bottleneck, so I tried various migration solutions, but in the end I gave up on migration.
Maintenance points for Rye environment construction in dotfiles management
- 2025/06/01
Taking the opportunity of migrating from Poetry to Rye, we reorganized the procedure for building a Python development environment using bare-repo style dotfiles management.
Migrating from Poetry to Rye and fully supporting Netlify builds
- 2025/05/31
I migrated the Python project that was managed with Poetry to Rye, which has been attracting a lot of attention recently, and also completed the configuration by deploying it with Netlify. In this article, I will record the steps and key points.
Comparison and usage of Poetry and Rye: Python project management options
- 2025/05/30
Poetry has long been a popular tool for dependency management and package publishing in Python projects. However, recently, a new tool called Rye has been attracting attention because it enables faster and simpler operations.
Comment out selection range in Neovim: Introduce comment.nvim with vim-plug
- 2025/05/29
When using Neovim, there are many situations where you especially want to comment out a certain range of code. In this article, we will introduce the lightweight Lua plugin comment.nvim using vim-plug to smoothly turn comments on and off according to file type.
Migrating from poethepoet to doit in a Python development environment and best practices
- 2025/05/28
In my Python project using Poetry, I used poethepoet to manage tasks, but I decided to migrate to doit for the following reasons.
Improving build performance of Sphinx documentation
- 2025/05/27
When building multilingual documents using Sphinx, we made performance improvements as the build time became longer. In this article, I will summarize the situation before and after the improvement, the process of trial and error, and the results obtained.
Measurement method for Sphinx build time (time command and Measure-Command)
- 2025/05/26
When building and operating a multilingual site with Sphinx, the time required to build the document may gradually increase. The first step in improving performance is to understand how much time the current build process is taking.
Publication of documents used in the gh-pages branch and organization of comparative knowledge
- 2025/05/25
I will summarize what I learned most about the mechanism for publishing documents using the gh-pages branch of GitHub Pages.
Basics of the Python task automation tool “doit”
- 2025/05/24
This is a work memo that explains the basic concept, introduction method, and simple usage examples of the task automation tool “doit” written in Python.
Publish Python code-linked documentation with MkDocs + mkdocstrings
- 2025/05/23
I experienced automatically generating API documentation from Python code and publishing it on GitHub Pages using MkDocs, so I would like to summarize the steps and impressions.
Steps to publish a self-introduction page on GitHub Pages using Poetry and MkDocs
- 2025/05/22
This is a practical memo that organizes the steps to create a simple static page using MkDocs and publish it to GitHub Pages while managing packages with Poetry.
Get a free PostgreSQL environment with Supabase
- 2025/05/21
When you want to use a free relational database in the cloud, Supabase is one of the most promising options. This article summarizes the basic points to quickly and safely start using a free PostgreSQL environment using Supabase.
Summary of copy-mode for copying with vi operation in tmux
- 2025/05/20
When connecting to a remote Ubuntu via SSH and working on tmux, it is very convenient to be able to copy using Vim-like operations. In this article, we will use copy-mode in tmux to introduce how to select and copy strings using just the keyboard without using the mouse.
Record of using Mockoon to quickly launch REST API Stub
- 2025/05/19
Recently, I often come across situations where the actual implementation of a REST API has been delayed, or a stub I created a long time ago no longer works, or I am in a hurry to perform front-end development and integration testing. In any case, Mockoon seems useful in situations where you need a minimum of Stub right now, so I have summarized the installation steps.
Automatically update pre-commit hooks with GitHub Actions
- 2025/05/18
We will introduce a mechanism to automatically execute pre-commit autoupdate periodically and create a hook version update PR via GitHub Actions.
Pre-commit hook configuration exhaustive template
- 2025/05/17
In this article, we will cover a wide range of pre-commit hooks that can be automatically executed before a Git commit, and organize them as configuration examples (templates). We assume that you will use it to “put everything in first and then delete what is unnecessary.”
pre-commit implementation notes
- 2025/05/16
In this article, we will explain how to introduce and utilize pre-commit, a tool that automatically formats and checks code and documents before committing to Git.
Tips to make keyboard operations more comfortable on the iPad
- 2025/05/15
If you normally work on Windows and want to connect a keyboard to your iPad and do some serious work, you may be confused by the differences in key layouts and gaps in shortcut operations. In this article, we have summarized how to replace modifier keys to increase work efficiency on the iPad, and useful key operations to remember.
How to set up an SSH environment on iPad for free (iSH + OpenSSH)
- 2025/05/14
Steps to build an SSH environment on an iPad using the free app iSH. Up to this point, we have set up an environment with zsh + neovim + tmux on Linux, so as long as we can establish an SSH connection, we can work at any time.
How to access the development HTTP server on Oracle Cloud with an SSH tunnel
- 2025/05/12
When managing a static site using Sphinx + ablog on an Ubuntu server on Oracle Cloud, you may want to check the display locally before git push. Even in situations where direct access via HTTP from the outside is not possible, you can check the site under development by using an SSH tunnel.
Plugin management in Neovim and GitHub Copilot introduction notes
- 2025/05/08
This is a record of building an auto-completion environment by installing a minimum number of plugins in the environment immediately after installing Neovim. In the first stage, we adopted vim-plug as our plugin manager and introduced GitHub Copilot as the first plugin.
How to avoid getting lost between vi and Emacs
- 2025/05/07
Two major editors for Linux: Vi and Emacs. There are few opportunities to use either of them, and if you are unfamiliar with them, you can easily get lost. Therefore, we have put together an article with the aim of covering even the bare minimum of operations.
Introduction and initial settings of Neovim, relationship with sudoedit and points to note
- 2025/05/06
The VSCode development style is sufficient on Windows, but if you dare to develop in a Linux environment, one option is to master the vi-based editor. In this article, we will introduce Neovim and organize its initial settings. We will also summarize the sudo nvim command and sudoedit that should be avoided.
Setting up automatic build to automatically publish Draft with Sphinx + ablog
- 2025/05/05
When running a blog with Sphinx + ablog, you can prepare draft articles by setting the post date to a future date. However, it will not be reflected on the website unless the build is run after the release date. This article looks at how to run automated builds.
Recreate your own private environment in a Linux environment
- 2025/05/04
We will summarize the steps and ideas for quickly starting up your own environment in a new Linux environment.
Modern shell environment setup starting with zsh + starship
- 2025/05/03
Don’t settle for “just using bash” with your newly acquired Linux. Introducing zsh and the high-speed, multifunctional prompt starship, we will set up the minimum necessary settings at once and build a modern shell environment.
Getting started with bare‑repo Linux dotfiles management
- 2025/05/02
In this article, we will organize dotfiles management using the Bare-repo method. There are dotfile management managers such as dotbot / yadm / homeshick / chezmoi, but in the beginning, the bare-repo method, which can be completed with just git, is sufficient. If I ever run into any problems, I will reconsider migrating to dotfile management manager.
Initial tasks performed in a Linux environment
- 2025/05/01
There are certain tasks you must perform every time you get a new Linux environment. However, it is inefficient to re-examine the work details every time. In this article, I summarized the initial setup and subsequent maintenance work that I did. Mainly assumes an Ubuntu-based environment.
Get a free Linux environment with Oracle Cloud
- 2025/04/30
We will record the steps to create a free instance on Oracle Cloud Free Tier and connect to SSH from Windows.
Dealing with conflicts between “/blog.html” and “/blog/index.html” in ablog
- 2025/04/02
When I was building a blog site using ablog, both /blog.html and /blog/index.html were generated in the output after the build, and there were situations where I was confused about the handling of URLs and link behavior. This article summarizes the causes and solutions.
Utilize Ablog for blog operation
- 2025/04/01
It is useful to use Ablog when you want to operate it more like a blog than pure Sphinx functions.
Rebuilding the python environment
- 2025/03/23
Summary of responses when rebuilding from python3.8 to python3.13 environment in sphinx+netlify environment
Upon restarting the site update
- 2025/03/22
Summary of what we did to restart the site update after a long time