def blog(config: ConfigParser) -> bool:
    """ Do what it takes to find the results, convert them to markdown, then
        write it out in Hugo-compatible Markdown. Hugo compatibility means
        putting some extra TOML variables at the item. It's not just raw markdown.
    """
    logger = logging.getLogger(__name__)

    analysis = read_json(config, 'analysis')
    if not analysis:
        logger.error(f"Problem with analysis file? No blog written.")
        return False

    # Create directory structure
    dir_path = create_journal_directory(config)
    if dir_path is None:
        return False

    blog_text = create_blog_text(config, analysis)

    # Blog file is index.md
    blog_filename = join(dir_path, "index.md")
    try:
        with open(blog_filename, '+w') as bfile:
            print( blog_text, file=bfile)
    except (OSError, IOError) as e:
        logger.critical(f"Failed to write blog text to {blog_filename}")
        logger.critical(e)
        return False
    except Exception as e:
        logger.critical(f"Failed to write blog text to {blog_filename}")
        logger.critical(e)
        return False
    return True

def create_blog_text(config: ConfigParser, analysis: dict) -> str:
    """ Write out the Markdown for the blog post with all the analysis.
    """

    logger = logging.getLogger(__name__)
    event_title = None

    year = config.get('mastoscore', 'event_year')
    month = config.get('mastoscore', 'event_month')
    day = config.get('mastoscore', 'event_day')

    # older data files had event_title, but not episode_title
    try:
        event_title = config.get('mastoscore', 'episode_title')
    except Exception as e:
        logger.debug("episode_title not found. Trying event_title")
    if not event_title:
        try:
            event_title = config.get('mastoscore', 'event_title')
        except Exception as e:
            logger.error("neither episode_title nor event_title found")
            event_title=f"{analysis['hashtag']} {year}-{month}-{day}"


    # Find our journal directory so we can see if there are text files
    # accompanying the images.
    journaldir = create_journal_directory(config)
    text_file_name = join(journaldir, f"{analysis['hashtag']}-{year}{month}{day}.txt")
    graph_alt_text = ""
    with open(text_file_name, 'r', encoding="utf-8") as tfile:
        graph_alt_text = tfile.read()

    text_file_name = join(journaldir, f"wordcloud-{analysis['hashtag']}-{year}{month}{day}-remove.txt")
    wordcloud_alt_text = ""
    with open(text_file_name, 'r', encoding="utf-8") as tfile:
        wordcloud_alt_text = tfile.read()

    # These bits of hugo markdown are a pain to type, so I'm assigning them to variables to make them
    # easier to work with.
    a = '{{< hilite >}}'
    b = '{{</ hilite >}}'
    # write out top boosts
    top = analysis['max_boosts']
    text = "\n\n"
    text = text + f"### The top {analysis['top_n']} boosted toots:\n"
    i=1
    for item in top:
        text = text + f'''
{i}. [This toot]({item['url']}) from [{item['account.display_name']}]({item['account.url']})
({item['userid']}) had {a}{item['reblogs_count']}{b} boosts.
> {item['content']}
'''
        i += 1
    boost_text = text

    # write out item favourites
    top = analysis['max_faves']
    text = "\n\n"
    text = text + f"### The top {analysis['top_n']} favourited toots:\n"
    i=1
    for item in top:
        text = text + f'''
{i}. [This toot]({item['url']}) from [{item['account.display_name']}]({item['account.url']})
({item['userid']}) had {a}{item['favourites_count']}{b} favourites.
> {item['content']}
'''
        i += 1
    text = text + "\n"
    faves_text = text

    # write out item replies
    top = analysis['max_replies']
    text = "\n\n"
    text = text + f"""### The top {analysis['top_n']} most-replied-to toots:

    (Note: this really should exclude people who reply to themselves, it doesn't do that well, yet)

"""
    i=1
    for item in top:
        text = text + f'''
{i}. [This toot]({item['url']}) from [{item['account.display_name']}]({item['account.url']})
({item['userid']}) had {a}{item['replies_count']}{b} replies.
> {item['content']}
'''
        i += 1
    replies_text = text

    try:
        fetch_info = read_json(config, 'fetch')
        fetch_text = "stuff"
    except Exception as e:
        # we don't care there was an exception. just using this for error handling
        fetch_text = ""

    summary_text = f"""
## Summary

{{{{< figure
    src="thumb.jpg"
    alt="(Movie poster placeholder)"
>}}}}

We looked at {a}{analysis['gross_toots']}{b} toots posted between {a}{analysis['event_start']}{b} and
{a}{analysis['event_end']}{b} by {a}{analysis['unique_ids']}{b} different participants across
{a}{analysis['num_servers']}{b} different servers. {a}{analysis['max_server']['name']}{b} contributed the
most toots with {a}{analysis['max_server']['num']}{b}.

Most toots were from '{analysis['most_posts']['name']}' ({analysis['most_posts']['id']})
who posted {a}{analysis['most_posts']['count']}{b}.
"""
    # Try to pluck the year of the film from the title. Film titles are usually something like
    # "The Swamp Thing (1982)"

    match = search(r'\((\d{4})\)', event_title)
    blog_tags = f'["{analysis['hashtag']}"'
    if match:
        film_year = match.group(1)
        blog_tags = blog_tags + f', "{film_year}"]'
    else:
        blog_tags = blog_tags + "]"

    graph_text = f"""
## Activity Graph

{{{{< figure
    src="{analysis['hashtag']}-{year}{month}{day}.png"
    alt="Activity graph. See main page for actual description."
>}}}}

{graph_alt_text}

"""
    wordcloud_text = f'''
## Wordcloud

{{{{< figure
    src="wordcloud-{analysis['hashtag']}-{year}{month}{day}-remove.png"
    alt="Word cloud. See main page for actual description."
>}}}}

{wordcloud_alt_text}

'''

    # Pull it all together, with the Hugo stuff at the item
    # TOML requires triple double quotes if you want to have newlines in a string.
    # So I have to do triple single quotes here.
    blog_text = f'''
+++

title = """{event_title}"""
date = {year}-{month}-{day}
draft = false
image = "{year}/{month}/{day}/{analysis['hashtag']}/wordcloud-{analysis['hashtag']}-{year}{month}{day}-remove.png"
description = """{analysis['hashtag']} graphs for {event_title}"""
tags = {blog_tags}
archives = ["{year}/{month}"]
author = "Paco Hope"

+++
{summary_text}
{boost_text}
{faves_text}
{replies_text}
{graph_text}
{wordcloud_text}

## Analysis details
{fetch_text}

Analysis of #{analysis['hashtag']} generated at {analysis['generated']}
'''
    return blog_text