[GUI Plugin] FanFicFare

[ownedbycats]

Originally Posted by JimmXinu

Congrats to AO3 for finally leaving Beta after 17 years.

Did you see their april fool's joke? lol.

[Jade Aislin]

The url should have the tag "workout au".


Regardless, I figured out the issue.


it was actually the second line of code, made worse by the first. Anytime the second line ran into "Alternate Universe", it would run creating the blank "AU:". So I changed it to this and it worked:

 genre=>(.*) [Aa][Uu](|!)=>Alternate Universe,AU: \1
 genre=>(Alternate Universe)( - )?(.+)=>\1,AU: \3

Thanks for the help. Your suggestions helped me think of alternatives.

[Comfy.n]

https://archiveofourown.org/admin_posts/34626

10 million registered users and 17 million fanworks

Amazing progress.

[JimmXinu]

Originally Posted by Jade Aislin

it was actually the second line of code, made worse by the first. Anytime the second line ran into "Alternate Universe", it would run creating the blank "AU:". So I changed it to this and it worked:

Yes. I only gave the one line as an example, but I meant you should change it in all lines where you were trying to split entries.

[ownedbycats]

Spotted on reddit: someone trying to use AI to make a FanFicFare personal.ini. Are replace_entities and strip_html_kept_paragraphs actual entries, or AI hallucination?

[JimmXinu]

AI being AI.

[vscogirl]

hi! after a lot of scrolling and reading I've finally got the title page of my epubs from AO3 looking exactly the way I want. But I've got two quick questions, any help would be lovely -
1) I've got this line:
make_linkhtml_entries: rating,fandoms,ships,characters,freeformtags,serie s00,series01,series02,series03,series04,series01HT ML,storyUrl
- except nothing really gets hyperlinked except the Series. What am I missing?
2) is there a way for only the freeformtags to be separated by | instead of commas on the title page?

Thank you!!

[JimmXinu]

Originally Posted by vscogirl

1) I've got this line:
make_linkhtml_entries: rating,fandoms,ships,characters,freeformtags,serie s00,series01,series02,series03,series04,series01HT ML,storyUrl
- except nothing really gets hyperlinked except the Series. What am I missing?

make_linkhtml_entries only works on entries that also have matching xxxUrl entries to create a xxxHTML entry.

series00,series01,series02,series03,series04 are the only valid parts of that line.

Originally Posted by vscogirl

2) is there a way for only the freeformtags to be separated by | instead of commas on the title page?

add_to_replace_metadata:
 freeformtags_LIST=>,=> |

[vscogirl]

Thanks for such a quick response! I've been trying to get the comma to change for so long!!

In essence, I have been trying to replicate the title page as close as possible to the title page on the epub when I download straight from Ao3. I sort of now have some more follow up questions:

1) the tags and such details on the title page are hyperlinked in the downloaded from Ao3 epub. is there a reason why I can't have it hyperlinked when I download via FFF?

2) I haven't tried to attempt these cosmetic changes in fear of ruining what I have but is it possible to do the following:
- change the data under the Series: section to be Part 1 of X instead of <hyperlinked series name [NUMBER]>
- have the stats entries lined up like -
Publishd: Updated: Status:
Words: Chapters:
- I was able to use output_css to move the description to a new page, but haven't been able to add it as a separate page on the TOC.
- When I tried to indent the entries under the ratings, archive warnings etc, it also indented the description. How can I indent only the Ratings to Stats part?

None of these are really necessary changes but I'd love to learn how to achieve it. Thanks again

[JimmXinu]

Originally Posted by vscogirl

1) the tags and such details on the title page are hyperlinked in the downloaded from Ao3 epub. is there a reason why I can't have it hyperlinked when I download via FFF?

FFF doesn't collect them.

The system for associating a name and URL like series is klunky at best and I just don't think it's worth it.

Originally Posted by vscogirl

2) I haven't tried to attempt these cosmetic changes in fear of ruining what I have but is it possible to do the following:
- change the data under the Series: section to be Part 1 of X instead of <hyperlinked series name [NUMBER]>

No. It's hard coded for seriesHTML and all make_linkhtml_entries.

Also, FFF doesn't collect the series length for each story, just it's number in the series. Both because many sites don't show the series length as part of the story metadata and because it's very common for it to have changed.

Originally Posted by vscogirl

- have the stats entries lined up like -
Publishd: Updated: Status:
Words: Chapters:

If you want to change the order, you need to set titlepage_entries. If you want to group them on the same line, see below.

Originally Posted by vscogirl

- I was able to use output_css to move the description to a new page, but haven't been able to add it as a separate page on the TOC.
- When I tried to indent the entries under the ratings, archive warnings etc, it also indented the description. How can I indent only the Ratings to Stats part?

Have you seen the Custom Output wiki page? Specifically for epub title page?

I suggest referring to the wiki page and then modifying titlepage_entry to include id or class attributes to make CSS easier.

The hard coded default is:

<b>${label}:</b> ${value}<br />

But if you use something like:

titlepage_entry:
 <div id="${id}"><b>${label}:</b> ${value}</div>
# note the leading space, it matters.

That will yield, for example:

...
<div id="status"><b>Status:</b> In-Progress</div>
<div id="datePublished"><b>Published:</b> 2026-03-20</div>
<div id="dateUpdated"><b>Updated:</b> 2026-04-03</div>
<div id="dateCreated"><b>Packaged:</b> 2026-04-07 16:09:26</div>
<div id="rating"><b>Rating:</b> Mature</div>
<div id="warnings"><b>Warnings:</b> No Archive Warnings Apply</div>
<div id="numChapters"><b>Chapters:</b> 3</div>
<div id="numWords"><b>Words:</b> 8,777</div>
<div id="publisher"><b>Publisher:</b> archiveofourown.org</div>
...

Then you can control the individual entries by #entryid.

(I suggest using Calibre's Edit book to workout your CSS rather than running dozens of downloads while testing.)

[ericar13]

Is there a way to force <details> html tags to download as <details open>?

I've noticed that sometimes authors use the details/summary tags to include optional fun facts or glossary terms. The html works correctly on Calibre's epub viewer, but when the fic is downloaded to my ereader (Kobo KLC), there's no way to toggle the section open.

Curious if there's a way to force include the open attribute, or maybe convert the whole section to another html element that's fully expanded?

Here's a link to a fic where the author has used this in the author's notes to include a glossary -

Moderator Notice
Link removed by mod - MR doesn't want NSFW links

Thank you in advance for any suggestions!

[JimmXinu]

Originally Posted by ericar13

Is there a way to force <details> html tags to download as <details open>?

FYI, MR doesn't want NSFW links posted. Please use SFW examples here in future.


I'll be honest, I had to look up what a <details> tag even is. It's an initially 'folded' element -- very similar in function to MR's [spoiler] tag. (And yet I remember <blink> )


FFF does have a setting you can use to replace the <details> tags with <span class="details"> tags you can then style with CSS:

## Tags listed here will be replaced with <span class="tagname">.
add_to_replace_tags_with_spans:,details

That's probably your best bet since applying an 'open' attribute to all <details> tags would still have problems with 'accordion' elements where multiple <details> tags have the same 'name' attribute.


The replace_tags_with_spans setting is intended for deprecated/removed tags. defaults.ini:

## Tags listed here will be replaced with <span class="tagname">.
## For example: <u>underlined text</u> becomes
## <span class="u">underlined text</span>
## Note that the output_css should contain the class .u, .big, etc for
## the spans to be useful.
## This feature is for replacing old tags deprecated/removed in newer
## HTML and EPUB standards.
replace_tags_with_spans:u,big,small

[ericar13]

Thanks for the response! For anyone else who encounters this problem, here's what I ended up with in my personal.ini file:

Spoiler:

## change <details> tags to <span class="details"></span> for easier readability on e-readers
replace_tags_with_spans:details

## add custom css for .details class
add_to_output_css:
	...
	.details {
		display: inline-block;
		border-top: 1px solid #ccc;
		border-bottom: 1px solid #ccc;
		padding: 5px 0;
	}
	.details summary {
		font-weight: bold;
	}

[JimmXinu]

Originally Posted by ericar13

## change <details> tags to <span class="details"></span> for easier readability on e-readers
replace_tags_with_spans:details

Be aware that the setting above removes <u>, <big>, and <small> from the list of tags to be replaced.

That's why I suggested:

add_to_replace_tags_with_spans:,details

See the INI wiki page for full details on add_to_ settings.

[ernand]

Hey! I am having problems replacing metadata in my personal.ini file.
I have a title containing () in the text, and I am unsure how to convert that.
All my other replacements work fine, but they do not have those symbols in the text.

Here is what I am trying to replace:
category=>^Overlord (MADHOUSE Anime).*$=>Overlord - Maruyama Kugane