Adding Comic Pages
Uploading comic pages to your website is as simple as copying the comic image file to a folder and editing a text file!
Open the comics directory. When you created your own comic_git repository in Getting Started, you created a copy of the original repository. This includes an example comic page to help you get started.
You can rename this page's folder to whatever you want, but be aware that it will show up in the URL for that page. E.g. https://[username].github.io/[repo name]/comic/Page 1/
Open the new directory you've created, and you should see a few files: English.txt, info.ini, post.txt, and an image file.
Comic File
First things first, delete the existing image file and copy whatever image file you want to use for your comic in its place. The name of your comic image file can be anything you want, even the same name as other comic image files in other folders. However, keep in mind that comic_git will use the name of your comic image as the title for that page, unless you specify otherwise (see the Page Info section for more info).
When building your website, comic_git will search through your comic folders for any image files in the same folder and add them to the web page for that folder. The images will be shown vertically in alphabetical order, according to their filenames.
Files with any of the following extensions are considered image files: jpg, jpeg, png, tif, tiff, gif, bmp, webp, webv, svg, eps
You can override this behavior by adding a Filenames option to your info.ini file, as described in the next section.
Page Info
Next, open info.ini. The file will look something like this:
# Uncomment the line below to give your comic page a specific title, otherwise comic_git will use the name of the image file
# Title = My First Comic Page!!
Post date = August 1, 2025
# You can delete any of the lines below if you don't want to use them.
Alt text = This is where your first comic page will go!
Storyline = Chapter 1
Characters = Alice, Bob, Eve
Tags = Tag 1, Tag 2, Tag 3Edit the values in this file to match the comic you are uploading.
When you're done, save and close info.ini.
News Post
Open post.txt in a text editor like Notepad. The file will look something like this:
If you'd like some ideas on what you can do next with comic_git...
* Replace the image on this page with your own comic image by replacing the `Page 1.png` file at `your_content/comics/001/`
* Update this page's Post Date, Tags, or other details by updating the `info.ini` file at `your_content/comics/001/`
...This is the file where you put any text that accompanies your comic upload, such as a news post update or a few snarky comments. This file supports both Markdown and HTML formatting, including CSS or JavaScript.
You can even embed images in this page, like so:
Sorry, guys, I'm sick so no comic today. Please enjoy a sad panda instead.
<img src="../../your_content/images/sad_panda.png">Transcript Files
comic_git comes with an example of a "transcript file" in this folder: English.txt. You can safely delete this file if you don't want to use transcripts in your comic.
See the documentation for Transcripts for more information.
And you're done! You've now created your first comic page! If you like, you can upload your changes now and see them on the web. Or if you prefer, you can first spend some time changing the colors, images, and other layout of your website.
Adding more pages in the future is as easy as copying the comic folder, renaming it, and following the same steps as above. If you wish to make changes to the comic after it's been posted, simply edit the image file in the folder. If you wish to edit the post or page info of any comic, just edit info.ini or post.txt. If you wish to delete a comic, just delete the whole folder.
Last updated