Other Expert Tips

Switching from a Public to a Private Repo

The main reason someone would want to make their comic_git repository private would be to be able to schedule posts while still publishing their website to GitHub Pages. If you wish to do so, you'll need to first upgrade your account to a GitHub Pro account for $4 per month.

Once you have GitHub Pro:

1. Go to your repo's Settings page.

2. Scroll all the way to the bottom to the section marked Danger Zone, and click the Change Visibility button.

   
3. Click Change to private.

   
4. A pop-up appears asking you to confirm that you want to make the repo private. Click I want to make this repository private.

   
5. A second pop-up appears advising you of the effects of making the repo private. Click I have read and understand these effects.

   
6. The first pop-up appears again. This time, I want to make this repository private highlights as red. Click a final time to complete the process.

   

You may need to re-enable GitHub Pages after making this change. Follow the Publishing to GitHub Pages instructions to do so.

Changing Archive Headers to Banner Images

One option creators frequently request is providing header images for their archive pages rather than the default text-only headers that come with comic_git.

This is fortunately very easy to do! You can use CSS to replace the <h2> tags that represent the headers with images! For example, if you create a Ch3.png file in the /your_content/images/ directory, you can replace your "Chapter 3" header with the following CSS in stylesheet.css:

#archive-section-Chapter-3 {
    display: inline-block;
    color: transparent;
    background: url("../../your_content/images/Ch3.png") no-repeat;
    background-size: contain;
    width: 100px;
    height: 100px;
}

You can do the same thing for the chapter link on the infinite scroll page using #infinite-scroll-Chapter-3 instead.

For both archive sections and infinite scroll links, be sure to set width and height to match the dimensions of the image you've provided.

Scheduled Posts

If you set the Post Date for a comic page for a future date or time (according to the Timezone you have set in your comic_info.ini file), comic_git will not create that page when you push your changes to GitHub. However, the comic data (image file, info.ini file, etc.) are not gone, and when comic_git runs for the first time on the date provided, the comic will be published then.

By default, comic_git reruns every morning at 8:00 AM UTC to publish any comic posts that may have been scheduled previously. That is either 12:00 am midnight or 1:00 am Pacific Time, depending on Daylight Savings Time. If you wish to change this update schedule, you can do so by updating the following line in your .github/workflows/main.yaml file:

    - cron: '0 8 * * *'  # Runs at 8:00 AM UTC every day

The text 0 8 * * * is what's called a "cron string" and it is a common way to tell computers when to perform automated tasks. This is a very powerful expression, but can be a little opaque. Fortunately, https://crontab.guru/ is an excellent resource for generating the correct cron string to represent whatever update schedule you want.

Note that the cron string is processed by GitHub assuming it's in UTC time. This means the update time changes with respect to most American timezones whenever Daylight Savings Time begins or ends. Unfortunately, there's no way to change this, so it's recommended that you either pick an update time in the middle of the night where your readers won't notice if the comic uploads one hour earlier for half of the year, or change the cron string whenever Daylight Savings Time changes.

Hiding Your Scheduled Posts

Despite the scheduled post protection above, any scheduled posts you want to hide from the public are still available to anyone who visits your GitHub page, if they know where to look. If you wish to make your scheduled posts completely hidden from the general public, you will need to set your repository to Private.

The Power of Jinja2

One of the main components of the architecture of comic_git that allows it to work as well as it does are Jinja2 Templates. Put very simply, Jinja2 templates are HTML files with extra syntax in them that act as placeholders for data that can be passed to the templates later to create a fully-fledged webpage. For example, there is a single template file that is used to create every comic page that's generated by comic_git. The following is an excerpt from the part where the page title and post date parts of the web page are created:

    <div id="blurb">
        <h1 id="page-title">{{ page_title }}</h1>
        <h3 id="post-date">Posted on: {{ post_date }}</h3>

When the Python script that builds all the web pages runs, it passes a variable called page_title to the template, which gets added where {{ page_title }} is in that template. Same with post_date.

There are many other features of Jinja2 templates that make them an incredibly powerful tool for automatically building a website that I won't go into here, but if you're interested in learning about them, I highly recommend reading through the Jinja2 documentation. I have also put a lot of effort into properly commenting and describing the existing template files in the comic_git_engine /templates/ directory to help anyone who wants look through them to figure out how comic_git works.

List of Values Available to Jinja2 Templates

Assuming you want to create your own Jinja2 templates (see Customizing Your Website for guidance on how to do that), it will be helpful for you to know what data the comic_git Python script makes available to the template whenever it builds a web page. The following is a list of all variables passed to the templates as they're being built, as well as a short description of each variable. The descriptions below assume you have basic knowledge of HTML, Jinja2, and Python data structures.

Variable	Description
template_name	The name of the template being loaded. E.g., comic
_title	The title of the page, as defined in the [Pages] section of the comic_info.ini file.
autogenerate_warning	A bit of text added to the top of every file when it's created to warn comic creators against trying to edit the HTML files directly. Not very useful for any other purpose.
version	The comic_git version, e.g. 0.2.1
comic_title	The comic name, as defined in the [Comic Info] section of the comic_info.ini file.
comic_author	The comic author name, as defined in the [Comic Info] section of the comic_info.ini file.
comic_description	The comic description, as defined in the [Comic Info] section of the comic_info.ini file.
banner_image	The web path of the banner image at the top of your website, as defined in the [Comic Settings] section of the comic_info.ini file.
theme	The name of the current theme that's in use.
comic_url	The URL of the homepage of your website, e.g. https://ryanvilbrandt.github.io/comic_git/. See Changing Your Website URL for information about changing this value, or you can host your webcomic from a custom domain.
base_dir	The base directory for your comic, aka your repository name while you're hosting from a GitHub Pages URL. It is important that all URLs that reference the root directory of your website use this variable, or have the correct root directory hardcoded in the template file.
comic_base_dir	The web path for the current comic being built. For the main comic, this will always be the same as {{base_dir}}, but for extra comics, the extra comic name will be added. e.g. /{{base_dir}}/extra_comic
content_base_dir	The web path where the your_content files are stored for the current comic being built. For the main comic, this will always be /{(base_dir)}/your_content, but for extra comics, the extra comic name will be added. e.g. /base_dir/your_content/extra_comic
links	The list of links that make up the Links Bar on your website, partially defined by the [Links Bar] section of the comic_info.ini file. This is a list of dictionaries, each with the format {"name": "<link name>", "url": "<link url>"}
use_thumbnails	The boolean value of the Use thumbnails option, as defined in the [Archive] section of the comic_info.ini file.
storylines	A dictionary of all the comics in the archive, grouped by their Storyline value as defined in their info.ini files. Any comics without a Storyline value are put into the "Uncategorized" storyline. The dictionary has the format {"<storyline>": [<comic_dict>, <comic_dict>, <comic_dict>, ...]}, and each comic is a dictionary of all the values comic_git needs to build a comic page, and then some. See the next table for a description of that.
home_page_text	The text contained in the /your_content/home_page.txt file. It is used by the default index.tpl file provided with comic_git.
google_analytics_id	Your Google Analytics Tracking ID, as defined in the [Google Analytics] section of the comic_info.ini file. If it's not defined, this value will be an empty string.
scheduled_post_count	The number of comic pages you have uploaded that have Post Dates set in the future, so web pages for those comics have not been built yet. Useful for teasing your audience with extra pages. This number will always be 0 if you have the publish_all_comics command line argument set to True.
extra_comics	A dictionary of all the extra comics defined for your site. The keys are the extra comic names, and the values are lists of the comic_data_dicts for that particular extra comic.
use_images_in_navigation_bar	The boolean value of the "Use images" option, as defined in the [Navigation] section of the comic_info.ini file.
navigation_bar_above_comic	The boolean value of the "Above comic" option, as defined in the [Navigation] section of the comic_info.ini file.
navigation_bar_below_comic	The boolean value of the "Below comic" option, as defined in the [Navigation] section of the comic_info.ini file.
navigation_bar_below_blurb	The boolean value of the "Below blurb" option, as defined in the [Navigation] section of the comic_info.ini file.
enable_webring	True if the Webring feature is enabled. False otherwise. See below for more variables related to the Webring feature.

If the Webring feature is enabled, the following variables may also be made available, depending on your chosen config options. See the feature description for more information about

Variable	Description
webring_label	The label of the webring, as returned by the endpoint.
webring_home	If a home is defined, this will be a dictionary of values as provided by the endpoint.
show_all_members	Matches the value of the "Show all members" config option. Default False.
webring_members	A list of dictionaries, one for each member of the webring, as returned by the endpoint.
webring_prev	A dictionary of values for the "previous" webring link, as returned by the endpoint.
webring_next	A dictionary of values for the "next" webring link, as returned by the endpoint.

In addition to the above information, the information for the most recent comic page is also passed to every template as it's built. The values below are specific to that comic page, and can be used for things like creating a landing page that shows the first comic image or even just the title and post date. This is also the same data provided in each comic_dict object in the storylines variable, described above.

Variable	Description
page_name	The unique identifier for the given comic page. This matches the name of the folder the comic is in, and the value in the URL for that comic page, e.g. 001 in https://ryanvilbrandt.github.io/comic_git/comic/001/
comic_paths	A list of the image filepaths for each comic. Each path is in the format your_content/comics/<page_name>/.
thumbnail_path	The path to find the thumbnail of the comic page, if it exists.
escaped_alt_text	The alt text of the comic, as defined in the comic's info.ini file, with all nonstandard characters replaced with HTML escape codes.
first_id	The page_name of the first comic on your site, sorted chronologically.
previous_id	The page_name of the previous comic.
current_id	The page_name of the current comic.
next_id	The page_name of the next comic.
last_id	The page_name of the latest comic.
page_title	The title of the comic, as defined in the comic's info.ini file.
_post_date	The post date of the comic, as defined in the comic's info.ini file.
archive_post_date	The post date of the comic, but formatted to match the date format in the [Archive] section of the comic_info.ini file.
_storyline	The storyline of the comic, as defined in the comic's info.ini file. If storyline is not defined, this will be None.
_characters	A list of the comic's Characters tags, as defined in the comic's info.ini file.
_tags	A list of the comic's Tags, as defined in the comic's info.ini file.
post_html	The contents of the post.txt file for the current comic, after being run through a Markdown parser to make it pure HTML.
transcripts	A dictionary of the transcripts for this comic, of the format {{"<language>": "<transcript text>"}}.
_on_comic_click	The value provided by the On comic click setting in your Comic settings section of your comic_info.ini file.

Any additional values found in the info.ini file for a particular comic will also be included in the Jinja variables. The names of these values will have all punctuation and spaces replaces with underscores, and an underscore will be prepended to the name of the value. E.g., Inker's Home Address will become _inker_s_home_address

If you want to add your own custom variables to the list of global variables, you can! See extra_global_values in Code Hooks for instructions.