Template:Cite digital book/doc

This template is for use when citing digital Forgotten Realms or Dungeons & Dragons books in a proprietary format, like for the Kindle. It calls Cite publication which is based on the Wikipedia cite book template. Use this template when you want to cite a passage from a digital book that has a location code for finding the passage. If your digital book has the actual page numbers from a hardback or MMP (mass-market paperback) book, then use Cite book instead of this. Sub-templates can be created for specific digital books. These will allow others to cite the same work without having to enter all the common information. You can view all the pre-made digital book templates here. If you need help on how to cite a reference, see Help:Citing sources.

Usage
Use the following format when creating a sub-template for a digital book:

All parameters are optional, but it will look pretty ugly if you don't supply at least the basics.
 * author : One or more author names, if applicable. If no author is specified, the editor field will appear in the author position (if specified). Names may be wikilinks if desired. Note that typical citations list  but our wikilinks are , so please use the wikilink format. If an author goes by an alias or has changed their name since their work was published, the original name may be appended to the current name with a forward slash  . Example:   will render as.
 * editor : One or more editor names, if applicable. Anthologies will have editors and those should be listed here. Wikilinks are allowed. This field will be appended with "ed." to distinguish it from the author. If a comma (", ") is detected in this field, it assumes there is more than one editor and will append "eds." If author is also specified, then the template assumes you are citing an anthology and this field will appear after short_story, prefaced with "In" and followed by title. (See example below.) Editor aliases may be specified in the same way as author aliases (see above).
 * date : This can be just a year (typical for books) or a month and year, or an exact date. It will be set off by parentheses in the output. Note that year also works for backward compatibility.
 * title : The title of the book, novel, or publication. This field should be wikilinked because someone should create an article describing the book. If you also specify short_story, then this should be the title of the anthology that contains the short story.
 * short_story : If the work you are citing is part of an anthology, then put the title of the short story here, otherwise you can omit this parameter or leave it blank. This field will be set off by double quotation marks ( “” ) in the citation.
 * format : The name of the reader used to view this digital book, e.g., Kindle, Nook, etc. This will appear after the title in parentheses and "ed.".
 * publisher : The company that published the work being cited. This is usually Wizards of the Coast, but could be others. Wiki links allowed.
 * location : The number representing the location in the digital book of the passage being cited. Note that the first unnamed parameter is assumed to be the location.
 * chapter : You may specify a chapter in addition to, or instead of, location. Knowing the chapter number will be more meaningful to people who have a paper copy of the book instead of a digital copy.
 * ISBN : The International Standard Book Number.
 * ASIN : An Amazon Standard Identification Number. Primarily used for Kindle editions, which will all list an Amazon ASIN. Do not use this in place of an ISBN if an ISBN is available, because that will limit the reader's choice of places to see information about the publication.

Examples
Here is a typical sub-template: which is found here and renders like this:

When you want to cite something with this template, you enclose it in  tags, like this: Adding the location: will render like this: Adding the chapter: will render like this: You can also used named parameters: and get the same result. Note: if you specify chapter without location, you need to use the named parameters or leave an empty unnamed parameter like this:

Unknown Chapters or Locations
If you cannot provide a location or a chapter for your citation, use the question mark (?) character for either parameter: This will place your article into a category for articles that need more specific locations.

E-Readers
Different e-readers may not use the same system to determine where in the book the information is, so that information found on a Kindle may not be in the same location on a Nook or other e-reader. In this instance, create a sub-template of the referenced book. For example, if you want to cite the Kindle version of Shadowbane, use Template:Cite digital book/Shadowbane/Kindle and set format to "Kindle"