amalthia: Stephanie Brown Batgirl (Stephanie Brown Batgirl)
[personal profile] amalthia
I've seen more requests on how to use Calibre plugins to download fic from archives into Calibre and how to merge series into a single file. This tutorial will first cover how to install plugins. As well as how to use the plugin Fanfiction Downloader to download fic from archives into Calibre and then the use of the plugin Epubmerge to merge series into a single file.


You can access the complete list of all the built-in plugins in calibre by going to Preferences->Plugins.

I've highlighted each step of the way on the screencaps.







This step is important. You'll need to pick Not installed from the dropdown list. This will list all the plugins you do not have installed. Scroll down until you find Fanfiction Downloader and Epubmerge. As well as any other plugins that you'll like to use. I highly recommend Count Pages. Install them one at at a time.


Once the installs are complete you'll need to restart Calibre.


The next part intended to help users to set up and use the plugin Fanfiction Downloader.

First make sure your plugin is visible on your main menu toolbar. To configure the plugin select the arrow next to the image and select configure plugin from the dropdown.



You will see a box that looks like this:



These are my personal settings and you can either copy or use defaults.

The second tab of settings called personal.ini and this is where you can enter your archive information such as username and passwords. This is useful for A03 because if you don't enter your username/password here you will get adult warning messages that popup asking if you are over 18. It becomes rather annoying very quickly.

The default code will list multiple archives like this:

[www.thewriterscoffeeshop.com]
#username:YourName
#password:yourpassword
#is_adult:true

In order for the program to work you will need to remove the pound sign # and add your information like this:

[ksarchive.com/]
username: fakeusername
password: fakepassword
is_adult:true

[archiveofourown.org]
username: fakeusername
password: fakepassword
is_adult:true

This is also where you can enter custom css code to add indents, change font size, text alignment, and etc... This is an example of my custom css. [This code goes at the end of all the archive login information].

output_css:
body { background-color: #%(background_color)s;
text-align: justify;
margin: 1%%; }
p {margin-top: 0pt; margin-bottom: 0pt; padding: 0pt; text-indent: 15pt; font-size: 1.29167em; text-align: justify;}
h1, h2, h3, h4, h5, h6 { text-align: center; padding-bottom: 10pt;}

.CI {
text-align:center;
margin-top:0px;
margin-bottom:0px;
padding:0px;
}
.center {text-align: center;}
.cover {text-align: center;}
.full {width: 100%%; }
.quarter {width: 25%%; }
.smcap {font-variant: small-caps;}
.u {text-decoration: underline;}
.bold {font-weight: bold;} .bold {font-weight: bold;}

My custom css adds indents to the paragraphs, centers chapter headers, and modifies the margins.

The other important tabs are the standard column and custom column:

In the standard column you can select which items you wanted filled every time you update the story. I only use it for my tags. This page shows what is added to calibre's columns.



The customize plugin tab is the one I found most interesting for my own fannish uses. You have to have custom columns to make this work. I have a custom column for Word Count, Relationships, Warnings, Status, and etc...When I download a story using the plugin it pulls metadata from the archive an automatically fills in the standard column information and everything I have selected in my custom columns. This means I don't need to worry manually adding pairings/relationships, warnings, word counts, and status (used to show if a story is complete or in-complete)



*note: Word Count will not work properly unless you have the plugin Count Pages installed. Please visit: Mobile Read Count Pages Plugin Thread to find out how to properly install and setup this plugin. Truly it's awesome for anyone that wants to know how long a story is without much effort.



To use the plugin you first need to copy the URL of the story you want to add to Calibre. Then click on the Fanfiction Downloader arrow and select from the drop down "Add New from URL" a box will pop up that looks like this:



When you're done your page may look like this:



Note of warning: I'm using my Calibre in screencaps. You will see my own custom columns that do not exist as the default when Calibre is installed. Custom Columns is a whole other tutorial. I use them to organize everything I download and they are incredibly useful. Kovid already has a video tutorial at the website Getting help with calibre under the link Grand Tour introductory video



Epubmerge does not require modifying any settings. Once the plugin is installed and Calibre is restarted you can start right away merging fic. Select the stories you want merged, a pop-up box will open and ask you to pick the order the stories should go in. Once you hit okay the metadata box will open. You can add your own summary, a series title, change the publisher/author/title, and etc...You can just hit okay and go with the default metadata.

That's the end of the tutorial. I put it together over the last two nights and I'm not an expert at making tutorials so please let me know if you find any errors so I can correct. I'm also willing to answer questions if you need further clarification. Hope this helps!

Date: 2012-11-06 10:56 am (UTC)
garryowen: (Default)
From: [personal profile] garryowen
This is great. Thank you.

Date: 2012-11-06 04:34 pm (UTC)
dorkpie: ([mulan] mulan: making a choice)
From: [personal profile] dorkpie
This was so helpful! I've actually been using Calibre and Mobireader for the longest time to read and download fic, but it seems like Calibre is the better option for organization.

Date: 2012-11-07 01:19 am (UTC)
valiha: watercolor painting of my cat Lola (Default)
From: [personal profile] valiha
This is very helpful, thanks so much! For the completed column, what type did you set it as? I was thinking about using a Yes/No column, but if I can get the plugin to populate it for me, then it's probably best to use a text column that behaves as tags?

Also, I haven't been able to figure this out, but what would I need to assign to my Category column which I use to mark whteher a work is gen, het etc., and the category at AO3? Because if I map my column to the offered category in FF plugin, my category gets populated with the fandom. If I'm making any sense.
Edited Date: 2012-11-07 02:39 am (UTC)

awesome!!

Date: 2012-11-17 02:35 pm (UTC)
talking_sock: sock (Default)
From: [personal profile] talking_sock
thank you for this post! Also, I did not know the fanfic downloader worked with KS archive. I thought I was just going to have to ignore that archive :-)

Hope you are well...

Date: 2013-09-29 12:54 am (UTC)
From: [personal profile] ex_matchboximpala863
WOOT! Thank you so much for this. I found it while doing a google search for information on why graphics in downloaded files were disappearing when I converted them using Calibre. I followed your directions for adding the downloader plug-in and then output the files as EPUBs. Then I used Calibre to then reformat them as MOBI files, which I can read on my Kindle Fire. The graphics were still there and some formatting problems I had noticed before had disappeared. This is fantastic and is going to make it so much easier to download fanfic from AO3 than the multi-step process I was using before. I really appreciate you taking the time to share these instructions.
Edited Date: 2013-09-29 12:55 am (UTC)

Most Popular Tags

Style Credit

Expand Cut Tags

No cut tags