Civil Footnotes

常見問題集

How do I use this plugin?

To create a footnote in a post, wrap the note in double parenthesis. For example, if I wrapped ((this in double parenthesis)), Civil Footnotes would interpret that as a footnote and convert it appropriately. This is a vast improvement over previous solutions which required you to manually keep a numbered reference in the text in sync with a note appended to the end.

Footnotes can be added to any post or page in WordPress. If you are using a plugin which provides Markdown support for your site, you may also include Markdown formatted text and links within your footnotes.

NOTE: You must include a space before the first parenthesis of your footnote; otherwise they will not display. This space will not be included in the final markup.

Why aren’t there any settings?

Civil Footnotes adheres to the WordPress project’s philosophy of “Decisions, not Options”. As a result there is no user-facing options configuration screen, and Civil Footnotes is designed to work as one might expect right out of the box.

If you do wish to change the behavior of the plugin, there are two ways in which a specific theme can alter how the footnotes render in code:

1. Your theme may provide custom CSS to style the footnote output. To style the reference numbers, style the <sup> tag in CSS. The footnotes at the bottom of a page use two css classes, .footnotes and .backlink, which may be used to apply additional CSS styling to those elements.

2. Your theme may specify the format of footnote marker. The available footnote markers are ‘decimal’, ‘lower-roman’, ‘upper-roman’, ‘lower-alpha’, ‘upper-alpha’, ‘lower-greek’, ‘upper-greek’, and ‘symbol’. To specify which marker is used on your site, you can add a filter function to the footnotes_style hook:

   // functions.php
   function mytheme_use_roman_numeral_footnotes( $style, $formats ) {
   return $formats[‘lower-roman’];
   }
   apply_filter( ‘footnotes_style’, ‘mytheme_use_roman_numeral_footnotes’, 10, 2 );

All available formats are specified in the keys of this filter’s $formats array.

I found a bug, how can I report it?

The best way to report a bug is to open an issue on the plugin’s GitHub repository explaining your problem. You can also start a discussion on the WordPress support forum.

May I suggest a new feature?

Absolutely! We cannot guarantee all feature proposals will be accepted; Civil Footnotes is deliberately lightweight and aims to remain so. If you have a suggestion, however, the best way to request a new feature is to open an issue on the project repository as described above in “I found a bug.”

Where can I download archived releases of Civil Footnotes?

From the Releases page of the plugin’s GitHub repository.