Changes

Jump to: navigation, search

Code4Lib Style Guide

877 bytes removed, 20:32, 4 August 2018
Add link to CSE style guide
 
== A Note About This Guide ==
 
This is a brief style guide for authors. For information about styles and conventions used in marking up articles for WordPress, see: [http://wiki.code4lib.org/Code4Lib_Journal_WordPress_Input_Guidelines Code4Lib Journal WordPress Input Guidelines].
== Start of Article ==
== Headings ==
Use H2 for main Major section headings, H3 for sub-sections, H4 if you need a lower level. H2 are in "Title Case" -- all words capitalized, short words (the, a, in, up, over, about) should not be. H3 and H4 Subheadings are in "Sentence case" -- only the first word is capitalized. == Figures & Tables == Figures and tables are centered, placed inside a P or DIV with class of "caption". For example: <pre>&lt;p class = "caption"&gt;&lt;img src = "...."&gt;&lt;strong&gt;Caption for Figure&lt;/strong&gt;&lt;p&gt; &lt;div class = "caption"&gt;&lt;table&gt;&lt;tr&gt;...&lt;/tr&gt;&lt;/table&gt;&lt;/div&gt;</pre> Captions for figures appear beneath the figure, centered, with "Figure X:" in bold, the descriptive text in sentence case, plain text. Captions for tables and code appear above the table, centered, with "Table X:" in bold, the descriptive text in sentence case, plain text. == Code == Code samples entered as preformatted text, as in the following example, are automagically color highlighted in Wordpress by the [http://wordpress.org/extend/plugins/syntaxhighlighter/ SyntaxHighlighter] plugin: <pre>[sourcecode language='php']RAW HTML/PHP/XML/Etc. code goes here; change language (in above line) as needed[/sourcecode]</pre> Supported formats include <tt>cpp, c, c++, c#, c-sharp, csharp, css, delphi, java, js, jscript, javascript, pascal, php, py, python, rb, ruby, rails, ror, sql, vb, vb.net, xml, html, xhtml, and xslt</tt>. Pretty much everything except <tt>perl</tt>. Note: do not surround code with <tt>&lt;pre&gt;</tt> tags, as the <tt>[sourcecode]</tt> tag itself will generate the necessary HTML.
== End of Document ==
=== Recommended Reference Style Discussion: ===
[https://writing.wisc.edu/Handbook/DocCSE_NameYear.html Council of Science Editors (CSE ) citation format] has been voted in as the official recommended style (see: [[Citation_discussion]])
=== Endnote & Endnote References ===
A Bibliography and Notes section (if needed) immediately follows the last of the article's narrative text. References are indicated by author and year (Smith, 2007). Notes are indicated in the text either by note number in square brackets [1]. More details can be found in the [[Code4Lib_Journal_WordPress_Input_Guidelines#Endnotes_style_and_HTML_coding|Input Guidelines for Endnotes]].
Bibliographies are recommended to follow CSE reference styleis the Journal's recommended style for bibliographies. An author may choose to use a different bibliographic reference style, but should follow that style accuratelyand consistently.
Authors can refer to this guide for using the [[CSE Reference Style]]
364
edits

Navigation menu