Fortran Wiki
HowTo

Contents

1. Getting Started
2. Instiki HowTo
3. Page Titles
4. Source Code
5. Mathematics
6. File Uploads
7. Download the Wiki
8. Referencing Books
9. Keyboard Shortcuts
10. News and Updates
11. Discussion
12. Guidelines for External Links

Getting Started

The Recently Revised page is the center of activity on the wiki. New information about the wiki itself, major changes to pages on the wiki, and news about the Fortran community in general can be found on the latest News page. The wiki can be searched directly from duckduckgo.com with keyword “!fwiki”.

Click “Edit” at the bottom of a page to see how pages are coded. Use the Sandbox to experiment.

To create a new page

• create a wiki link to the new page (as indicated by a question mark) by typing the name of the new page in double square brackets;

• click on the question mark, enter the content in wiki markup, fill in your name, and click submit.

Note: page names are case sensitive, so make your link using the guidelines below. You can make “aliased links” [[Like this|like this]] to link to a capitalized page name while still using the correct capitalization in the text.

When you edit a page, you can (and should) put your name (with normal capitalisation and spacing) in the box after “Submit as”. If you don’t, then your contribution will be credited to the AnonymousCoward.

When you edit a page for the first time, your name will appear at the bottom with a question mark since there is no page with your name yet. You may take this as an invitation to create a user page and tell us about yourself. If you don’t want to or don’t have the time right now, you can simply ignore this. If you just want to show up on category: people, then you make a page containing only category: people (or someone else may do this for you).

If you want to create your user page, simply click the question mark that appears next to your name at the bottom of the page after making a modification and add content to the edit box that appears. If you’d like to make a user page prior to modifying an existing page, you can do so by making some trivial modification to the Sandbox, which will put your name at the bottom of the page where you can click the question mark (or just hack the URL).

Instiki HowTo

For general information and help with Instiki, see the Instiki wiki.

Here are some useful specifics:

• Use basic Markdown syntax
• Make tables, footnotes, etc
• Add metadata to your markup
• Type itex equations
• Use wiki syntax
• Embed SVG in equations
• Use keyboard shortcuts
• Make slideshows

Page Titles

The first word of page titles should be capitalized. Other words should be capitalized if they are always capitalized. Page titles corresponding to filenames or identifiers in the Fortran language should be in all lowercase. Uppercase should only be used when the title is always written in uppercase.

Examples:

• Intrinsic procedures (standard capitalization)
• GNU Free Documentation License (words that are always capitalized)
• cpu_time (Fortran language keyword)
• proc_component_example (file/module name)
• FORTRAN 77 (uppercase name)

Note that you can always link to the page however you like using aliased links. For example, [[double precision|DOUBLE PRECISION]] will create a link titled DOUBLE PRECISION.

Source Code

Syntax highlighting of Fortran, Ruby, XML, and YAML is supported for code blocks with the appropriate lang attribute. This attribute can be specified on this wiki using Maruku’s metadata syntax on indented or fenced code blocks as follows:

Indented code blocks:

    program hello
        print *, "Hello, world!"
    end program hello

{: lang=fortran }

Fenced code blocks:

~~~~~~~~~~~ {: lang=fortran }
program hello
    print *, "Hello, world!"
end program hello
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Currently supported languages are:

html, xml, ruby, ansic, javascript, yaml, sqlite, css, fortran

Mathematics

Inline LaTeX expressions will be converted to MathML for display. See, for example, the page for the gamma intrinsic which includes the Gamma function.

To be exact, math on the Fortran Wiki is written using itex, a dialect of LaTeX designed for generating MathML for use on the web. There is a comprehensive itex reference on the xbeta wiki.

File Uploads

Files no larger than one megabyte can be uploaded to the wiki and linked to from any page. See Instiki:File Uploads for detailed instructions on uploading and linking to files. This can be used to include images in pages or simply to link to files for downloading.

Downloading the Wiki

Do not worry that your contributions to the wiki are locked away in some database or only available online. Actually, the entire wiki is always available for downloaded in a number of formats including HTML, plain text and LaTeX. PDFs can be easily created via pdflatex using the LaTeX export. Thus, your contributions will remain free and portable and the entire wiki can be distributed easily for reuse, offline reading, or simply for the sake of redundancy.

Referencing Books

When referencing books, please use the Fortran Wiki Amazon referral code. In case someone decides to purchase a book found on the wiki, a small percentage of the sale will go to help support the wiki. All that is required is the ISBN number of the book, which can be found via a quick search. Proper Amazon referral links have the form

http://www.amazon.com/exec/obidos/ASIN/<ISBN>/fortran-wiki-20

where <ISBN> is the book’s ISBN-10 code.

Keyboard Shortcuts

The rules for access keys are browser-specific. For example, in Firefox for Linux, access key X is activated by pressing Alt+Shift+X. Your particular browser may have different rules. The access keys defined on this wiki are listed below. Some keys, such as S are context specific depending on whether you are viewing a page or editing a page.

• E: edit the current page
• U: go to Recently Revised (mnemonic: “updates”)
• H: go to HomePage
• A: go to All Pages
• S: page history; save the current edit
• C: show or hide changes; cancel the current edit
• B: back in time (previous revision)
• F: forward in time (next revision)
• X: export the wiki
• W: edit web

News and Updates

The News pages are intended for announcing significant updates on the wiki (new pages, major revisions, etc.) as well as news about Fortran and the Fortran community. Feel free to post any relevant news you wish to share to the current News page. The sidebar news link will always point to the latest news page while the News page is primarily for archival purposes.

The wiki also provides two Atom feeds to make staying updated easy:

• Full content
• Headlines only

Discussion

See the main Discussion page for details.

Guidelines for External Links

Rather than simply creating an external link to a new resource, it is preferable to create a new wiki page about the resource in question, which should contain the external link, but should also say something useful about it. If you don’t have much to say about it at this time, the initial page can be a simple as a brief description of the topic followed by the link. Other people can fill in more details over time to create a richer page.

This guideline is intended to ensure the wiki remains focused on content and to avoid pages that are simply full of external links.