Fandom Calibre Screencap Tutorial (Guide to fandom plugins)
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!
http://amalthia.dreamwidth.org/785544.html#comments
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!
http://amalthia.dreamwidth.org/785544.html#comments