這個外掛並未在最新的 3 個 WordPress 主要版本上進行測試。開發者可能不再對這個外掛進行維護或提供技術支援,並可能會與更新版本的 WordPress 產生使用上的相容性問題。

WP ragadjust

外掛說明

WP ragadjust is an extremely simple plugin that includes ragadjust.js on your web pages. Ragadjust.js is a script written by @nathanford and envisaged by @markboulton which resolves several typographical violations relating to the rag that are common on the web:

  • Line breaks immediately following a preposition
  • Line breaks immediately following a dash
  • Small words at the end of a line
  • Consecutive hyphenation
  • (Line) broken, short emphasised phrases

Solving these issues improves the overall readability of your content.

Read the article behind the idea.

螢幕擷圖

  • Before / After ragadjust.

安裝方式

  1. Upload wp-ragadjust to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Done!

常見問題集

Which elements are _ragadjust_ed by default?

By default ragajust is applied to p tags.

Can I change which elemnts are adjusted?

Yes, you can use the wpr_elements filter to make adjustments to the selectors.

To add a new selector:

add_filter( 'wpr_elements', 'wpr_new_selectors' );
function wpr_new_selectors( $elements ) {
    $elements[] .= '.textwidget'; // Adjust text widgets in addition to p
    return $elements;
}

To remove a current selector:

add_filter( 'wpr_elements', 'wpr_remove_elements' );
function wpr_remove_elements( $elements ) {
    unset( $elements['0'] ); // Unset 'p'.
    return $elements;
}

To use your own, entirely unique selectors:

add_filter( 'wpr_elements', 'wpr_custom_elements' );
function wpr_custom_elements( $elements ) {
    $elements = array(
            'article',
            'footer',
        );
    return $elements;
}

These snippets should go in your child themes functions.php file.

Can I change the method used?

Yes. By default all methods will be used to fix all violations. If however you only want to fix prepositions and ignore everything else you can do so via the wpr_method filter like so:

add_filter( 'wpr_method', 'wpr_custom_method' );
function wpr_custom_method( $method ) {
    $method = 'prepositions';
    return $method;
}

The method options are:

  • emphasis – Text of three or less words in bold or italics does not break across lines.
  • small-words – Breaks lines before words of three or less characters.
  • prepositions – Breaks lines before prepositions.
  • dashes – Breaks lines before hyphens and dashes.
  • all (default) – All of the above.

使用者評論

2016 年 9 月 3 日
Makes pages more readable. 🙂
閱讀全部 5 則使用者評論

參與者及開發者

以下人員參與了開源軟體〈WP ragadjust〉的開發相關工作。

參與者

將〈WP ragadjust〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

1.0.0

Initial release.