Difference between revisions of "D12 MLA Citations Documentation"

Latest revision as of 20:05, 21 January 2017

d12 MLA Citations Plugin
Easily add MLA style citations to your WordPress pages and posts.

Usage

Complete instructions are available here.

Technical information is here.

Installation

You can install it from the WordPress admin, or via FTP. You can view both versions on the plugin's installation page on wordpress.org.

Screenshots

Screenshots are available on the plugin page on wordpress.org.

FAQ

Will this plugin handle multiple authors?

Yes, just enter it as you want it to appear: Updike, John, and Henry David Thoreau

Do I need to add quotation marks around article titles?

No, the plugin will handle it for you.

Do I need to italicize book titles, journal titles, or magazine titles?

No, the plugin will automatically italicize the titles of books, magazines, and academic journals.

What's the difference between adding "Additional information" at the end of a citation and adding a note to a citation?

The "Additional information" will be appended to the end of the citation paragraph. A note gets added below it, in a separate paragraph. See the screenshots for an example.

What's the difference between "end punctuation" and "internal punctuation"?

"End punctuation" is what comes at the end of each part of the citation. For example, a period after the author(s), another period after the title, etc.

"Internal punctuation" refers to punctuation within each part of the citation, for example, the comma in the author's name: "Lastname, Firstname".

The highlighting and clear floats plugins do not show up in the drop-down menu.

No, but they will be added in a future update. They can still be accessed by adding the appropriate shortcode manually.

I made a mistake in one of my citations. Do I need to delete it and start over again?

No. All your data is entered into your post as a shortcode, so you can edit your data in the shortcode.

Customizing

If you wish to override any of the default styles, create a child theme and redefine the following classes and id however you like:

The css id #d12src wraps the entire "Works Cited" section and adds the border.
The css class .d12srcp is appended to each paragraph that contains a citation.
The css class .d12citenote is appended to each paragraph that contains a [note].
the css class .d12mlatitle is appended to the paragraph that contains "Works Cited".

Suggestions and Problems

If you have a problem, or want to suggest a feature, please do so on the plugin's dedicated support forum over on wordpress.org.

@@ Line 1: / Line 1: @@
+{{Template:NoticeBoard
+|icon=Plugins_Icon.png
+|color=21759b
+|notice=d12 MLA Citations Plugin
+|text=Easily add MLA style citations to your WordPress pages and posts.
+}}
+== Usage ==
+Complete instructions are available [[d12 MLA Citations Usage | here]].
+Technical information is [[d12 MLA Citations Technical Information | here]].
+== Installation ==
+You can install it from the WordPress admin, or via [[FTP]]. You can view both versions on the plugin's [https://wordpress.org/plugins/make-it-so/installation/ installation page] on wordpress.org.
+== Screenshots ==
+Screenshots are available on the plugin page on [https://wordpress.org/plugins/d12-mla-citations/screenshots/ wordpress.org].
+== FAQ ==
+=== Will this plugin handle multiple authors? ===
+Yes, just enter it as you want it to appear: Updike, John, and Henry David Thoreau
+=== Do I need to add quotation marks around article titles? ===
+No, the plugin will handle it for you.
+=== Do I need to italicize book titles, journal titles, or magazine titles? ===
+No, the plugin will automatically italicize the titles of books, magazines, and academic journals.
+=== What's the difference between adding "Additional information" at the end of a citation and adding a note to a citation? ===
+The "Additional information" will be appended to the end of the citation paragraph. A note gets added below it, in a separate paragraph. See the screenshots for an example.
+=== What's the difference between "end punctuation" and "internal punctuation"? ===
+"End punctuation" is what comes at the end of each part of the citation. For example, a period after the author(s), another period after the title, etc.
+"Internal punctuation" refers to punctuation within each part of the citation, for example, the comma in the author's name: "Lastname, Firstname".
+=== The highlighting and clear floats plugins do not show up in the drop-down menu. ===
+No, but they will be added in a future update. They can still be accessed by adding the appropriate shortcode manually.
+=== I made a mistake in one of my citations. Do I need to delete it and start over again? ===
+No. All your data is entered into your post as a shortcode, so you can edit your data in the shortcode.
+== Customizing ==
+If you wish to override any of the default styles, create a [http://techblog.kjodle.net/2014/04/12/wordpress-child-themes-the-whys-and-hows/ child theme] and redefine the following classes and id however you like:
+*The css id <span class="mono">#d12src</span> wraps the entire "Works Cited" section and adds the border.
+*The css class <span class="mono">.d12srcp</span> is appended to each paragraph that contains a citation.
+*The css class <span class="mono">.d12citenote</span> is appended to each paragraph that contains a [note].
+*the css class <span class="mono">.d12mlatitle</span> is appended to the paragraph that contains "Works Cited".
+== Suggestions and Problems==
+If you have a problem, or want to suggest a feature, please do so on the plugin's [https://wordpress.org/support/plugin/d12-mla-citations dedicated support forum] over on wordpress.org.
 [[Category:WordPress]]
 [[Category:WordPress Plugins]]