Skip to main content
SearchLogin or Signup

How to Make a Pub

This article is a collection of examples and instructions for creating a new article in IJAMM. IJAMM uses the PubPub publishing platform. More information about PubPub can be found at pubpub.org.

Published onApr 11, 2019
How to Make a Pub
·

Abstract

This article is a collection of examples and instructions on the formatting and editing tools for articles in IJAMM. IJAMM uses the PubPub publishing platform. More information about PubPub can be found at pubpub.org.

If you are looking for author guidance and instructions on how to submit articles to IJAMM, please see:

Creating a New Article

IJAMM administrators can click the New Pub button in the top navigation bar to create a new article.

Formatting Your Article

Basic text formatting

Basic text formatting works as you would expect it to in any WYSIWYG word processor. You can easily add bold text, italcized text, superscripts, subscripts, and strikethrough to any letter, word, or phrase by highlighting it and clicking on the appropriate formatting button.

Once you highlight a letter, word, or phrase, a small hover menu above the highlighted selection will appear offering shortcuts for common formatting choices:

<p>Figure 1: Highlight text to pop up a mini menu.</p>

Figure 1: Highlight text to pop up a mini menu.

Pre-defined styles

There is a short styles menu on the left end of the formatting toolbar. On it you will find the basic Paragraph style (the default), styles for three levels of headers, Header 1, Header 2, Header 3, and the Code Block style.

Organization and sections

PubPub will automatically create a table of contents for your article with up to three levels of hierarchy, if you use the pre-defined Header N styles. As there are only three levels available, we recommend you use Header 1 for your section headings, Header 2 for sub-sections, and Header 3 for sub-sub-sections, rather than using Header 1 for an article title. The title will automatically be rendered based on the article’s metadata.

Lists

Two styles of lists are available for bulleted and enumerated lists. Both lists can be multiple levels deep. Begin your list by clicking on the bulleted or enumerated list buttons in the formatting bar, then enter your items. To get out of list mode, click the button again after you have entered your last item, or hit the Return or Enter key on an empty bullet at the end of the list. To increase and decrease your level of indentation, use Tab and Shift-Tab.

List examples

  • Item 1

    • Sub-item 1

    • Sub-item 2

  • Item 2

  1. Item 1

    1. Sub-item 1

    2. Sub-item 2

  2. Item 2

  1. Item 1

    • Sub-item 1

    • Sub-item 2

  2. Item 2

Quotations

This formatting control will usually be styled as an indented paragraph, used for quotations. The icon on the formatting toolbar is a double quotation mark.

It was the best of times, it was the worst of times, it was the age of wisdom, it was the age of foolishness, it was the epoch of belief, it was the epoch of incredulity, it was the season of Light, it was the season of Darkness, it was the spring of hope, it was the winter of despair, we had everything before us, we had nothing before us, we were all going direct to Heaven, we were all going direct the other way – in short, the period was so far like the present period, that some of its noisiest authorities insisted on its being received, for good or for evil, in the superlative degree of comparison only.

The above example quotation is taken from Charles Dickens’ A Tale of Two Cities.

Equations

Rejoice! PubPub includes an inline LaTeX module that allows you to add equations and mathematical notation using LaTeX markup anywhere in your document. Equations can be in their own block:

i=1ni2=n(n+1)(2n+1)6\sum_{i=1}^n i^2 = \frac{n(n+1)(2n+1)}{6}

They can also be written inline ixisum_ix^i within a line of text.

To insert an equation select the formatting dropdown menu from the toolbar, labeled with and select Equation from the menu. PubPub will insert a placeholder expression at your cursor position. Click on the placeholder expression, and you will get an editing block instead of the formatting toolbar that allows you to enter LaTeX code into a code box, and allows you to switch from inline to block display and back.

Inline code or plain text

The button on the formatting tool bar with the angle brackets surrounding the / character will format a select as an inline code snippet, and can be used for source code or to format something as inline plain text in a fixed width font.

For example, in Python it is usually best practice to chain comparison operators, with if a <= n <= b being preferable to if a <= n and n <= b.

Citations and Citation Lists

[1]This is a citation

This is a citation list

Footnotes and Footnote Lists

1This is a footnote

This is a footnote list

Horizontal Lines

Horizontal line separators can be inserted using the Horizontal Line command from the formatting drop-down menu, accessed via the in the formatting toolbar. Horizontal lines will usually span the width of the content block they are in. They can be full width:


Or span a narrower section of the page if used within narrower blocks, such as quotations:

It is a far, far better thing that I do, than I have ever done; it is a far, far better rest that I go to than I have ever known.


Tables

A table can be inserted using the Table command from the formatting drop-down menu, accessed via the in the formatting toolbar. After inserting a table, which will put a 3x3 table into your article at your cursor location, while you are editing inside the table area you will see a new menu added to your formatting toolbar, the Table menu.

Use the Table menu to access standard table commands, such as inserting and removing rows and columns, adding header rows or header columns, merging or splitting cells, and deleting the table

If a researcher says a cool new technology should be available to consumers in…

What they mean is…

The fourth quarter of next year

The project will be canceled in six months.

Five years

I’ve solved the interesting research problems. The rest is just business, which should be easy, right?

Ten years

We haven’t finished inventing it yet, but when we do it’ll be awesome.

25+ years

It has not been conclusively proven impossible.

We’re not really looking at market applications right now.

I like being the only one with a hovercar.

Source code

Source code can be embedded inline using the Code Block paragraph style.

def fib(n):
    if n == 1 or n == 2:
    return(1)
else:
    return(fib(n-1) + fib(n-2))

Media

Files

Images

Videos

Audio files

Other files

Embedded App Views

YouTube

Codepen

Vimeo

SoundCloud

iFrame (other web apps)

Inviting Contributors

Adding Dynamic Content

Footnotes
1
Citations
1
Comments
0
comment

No comments here