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:
IJAMM administrators can click the New Pub button in the top navigation bar to create a new article.
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:
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.
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.
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.
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.
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:
They can also be written inline 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.
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.
This is a citation
This is a citation list
1This is a footnote
This is a footnote list
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.
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.
I’ve solved the interesting research problems. The rest is just business, which should be easy, right?
We haven’t finished inventing it yet, but when we do it’ll be awesome.
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 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))
iFrame (other web apps)
Adding Dynamic Content