Test Page

Date

28th May 2019

Modified

2019-07-28 14:18

Author

Matthew Tunstall

Note

This is a test page that is used to check/test the styling of the site. Some elements may appear broken, this may or may not be on purpose.

This is my test page. I am going to use it try out a few ideas that might end up elsewhere.

Text Formatting

This is some bold text

This is some italic text

Text cannot be bold and italic using plain reStructuredText. To achieve it requires CSS styling.

This is bold and italic

This is some general body text. This is some general body text. This is some general body text. This is some general body text. This is some general body text. This is some general body text. This is some general body text. This is some general body text.

This is some indented body text. This is some indented body text. This is some indented body text. This is some indented body text. This is some indented body text. This is some indented body text. This is some indented body text. This is some indented body text.

This body text is indented even more. This body text is indented even more. This body text is indented even more. This body text is indented even more. This body text is indented even more. This body text is indented even more. This body text is indented even more.

This is some general body text. This is some general body text. This is some general body text. This is some general body text. This is some general body text. This is some general body text. This is some general body text. This is some general body text.

---

Title 1

This section was headed by Title 1

Title 2

This section was headed by Title 2

Title 3

This section was headed by Title 3

Title 4

This secton was headed by Title 4

Recommended

This is a new recommended box that contains a very long line of text that will need to ideally wrap around.

---

This is some text in a container.

https://github.com/sphinx-doc/sphinx/blob/master/sphinx/directives/other.py

RST Directives

Custom ID & Class Atributes

RST Google Code Prettify

Python Highlight Example

---

Inbuilt Admonition Styling

Attention

More Text Text

Caution

Text

Danger

Text

Error

Text

Hint

Text

Important

Text

Note

Text

Tip

Text

Warning

Text

See also

Text

---

Custom Admonition Styling

ToDo

Text

Recommended

Text

This is command line text. This is a second line of text.

This is root command line text.

---

Nested Admonitions

Hint

Caution

Tip

Hello

---

This is a filebox

/home/matt/Git This is my git repo

This is the content of a file.
It may need some work
to handle multiple lines.
Another line.

This is a filebox, wrap = True

/home/matt/Git This is my git repo

This is the content of a file. It may need some work to handle multiple lines. Another line.

Multiline filebox works :)

Python Highlight Example

#!/usr/bin/env python
"""
show how to add a matplotlib FigureCanvasGTK or FigureCanvasGTKAgg widget and
a toolbar to a gtk.Window
"""
import gtk

from matplotlib.figure import Figure
from numpy import arange, sin, pi

# uncomment to select /GTK/GTKAgg/GTKCairo
#from matplotlib.backends.backend_gtk import FigureCanvasGTK as FigureCanvas
from matplotlib.backends.backend_gtkagg import FigureCanvasGTKAgg as FigureCanvas
#from matplotlib.backends.backend_gtkcairo import FigureCanvasGTKCairo as FigureCanvas

# or NavigationToolbar for classic
#from matplotlib.backends.backend_gtk import NavigationToolbar2GTK as NavigationToolbar
from matplotlib.backends.backend_gtkagg import NavigationToolbar2GTKAgg as NavigationToolbar

win = gtk.Window()
win.connect("destroy", lambda x: gtk.main_quit())
win.set_default_size(400,300)
win.set_title("Embedding in GTK")

vbox = gtk.VBox()
win.add(vbox)

fig = Figure(figsize=(5,4), dpi=100)
ax = fig.add_subplot(111)
t = arange(0.0,3.0,0.01)
s = sin(2*pi*t)

ax.plot(t,s)

canvas = FigureCanvas(fig)  # a gtk.DrawingArea
vbox.pack_start(canvas)
toolbar = NavigationToolbar(canvas, win)
vbox.pack_start(toolbar, False, False)

win.show_all()
gtk.main()

C++ Highlight Example

void RunningLights(
    uint8_t R, uint8_t G, uint8_t B,
    uint8_t (&array)[NUM_LEDS][3],
    uint16_t WaveDelay) {

    // Compile Time Check for global NUM_LED value
    static_assert(NUM_LEDS > 0, "RunningLights - NUM_LEDS needs to be > 0");
    static_assert(NUM_LEDS <= 255, "RunningLights-NUM_LEDS needs to be <=255");

    uint8_t Position = 0;
    uint16_t j; // j needs to be large enough to hold MAX NUM_LED, 255*2 = 510.
    for(j=0; j<NUM_LEDS*2; j++){
        Position++; // = 0; //Position + Rate;
        for(uint8_t i=0; i<NUM_LEDS; i++) {
            setPixelRGB(((sin(i+Position) * 127 + 128)/255)*R,
                    ((sin(i+Position) * 127 + 128)/255)*G,
                    ((sin(i+Position) * 127 + 128)/255)*B,
                    i,pixels);
        }
        writeLED(pixels,NUM_LEDS,DMA_Buffer);
        delay_ms(WaveDelay);
    }
}

C++ Highlight Example

void RunningLights(
    uint8_t R, uint8_t G, uint8_t B,
    uint8_t (&array)[NUM_LEDS][3],
    uint16_t WaveDelay) {

    // Compile Time Check for global NUM_LED value
    static_assert(NUM_LEDS > 0, "RunningLights - NUM_LEDS needs to be > 0");
    static_assert(NUM_LEDS <= 255, "RunningLights-NUM_LEDS needs to be <=255");

    uint8_t Position = 0;
    uint16_t j; // j needs to be large enough to hold MAX NUM_LED, 255*2 = 510.
    for(j=0; j<NUM_LEDS*2; j++){
        Position++; // = 0; //Position + Rate;
        for(uint8_t i=0; i<NUM_LEDS; i++) {
            setPixelRGB(((sin(i+Position) * 127 + 128)/255)*R,
                    ((sin(i+Position) * 127 + 128)/255)*G,
                    ((sin(i+Position) * 127 + 128)/255)*B,
                    i,pixels);
        }
        writeLED(pixels,NUM_LEDS,DMA_Buffer);
        delay_ms(WaveDelay);
    }
}

---

Attempt to put a code-block inside an admonition directive.

It doesn’t work as intended.

Recommended

Python Highlight Example

#!/usr/bin/env python
# sercom_mon.py - Serial Monitor Script
"""
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
"""

import serial
ser = serial.Serial('/dev/ttyUSB0',9600)

def main():
while True:
while(ser.inWaiting() > 0):
print(ser.readline().rstrip())

if \__name_\_ == "__main__":
# Someone is launching this directly
main()

# This is a long line of text to test the code highlighting plugin. This is a long line of text to test the code highlighting plugin.This is a long line of text to test the code highlighting plugin.This is a long line of text to test the code highlighting plugin.

Removing the code-block caption and placing the caption text directly into the admonition resolves the formatting issue.

Recommended

Python Highlight Example

#!/usr/bin/env python
# sercom_mon.py - Serial Monitor Script
"""
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
"""

import serial
ser = serial.Serial('/dev/ttyUSB0',9600)

def main():
while True:
while(ser.inWaiting() > 0):
print(ser.readline().rstrip())

if \__name_\_ == "__main__":
# Someone is launching this directly
main()

# This is a long line of text to test the code highlighting plugin. This is a long line of text to test the code highlighting plugin.This is a long line of text to test the code highlighting plugin.This is a long line of text to test the code highlighting plugin.

---

A Simple Table

Header1	Header2	Header3
Column1	Column2	Column3
Column1	Column2	Column3
Hor Column Span		Column3
Column1	Column2	Column3

Another Simple Table

Column A	Column B	Column C
One	Two	Three
Four	Five	Six
Seven	Eight	Nine

A Grid Table

Grid Table	Header2	Header3
Column 1	Column 2	Vertical column span
Horizontal Span

A Wide Grid Table

Grid Table	Header2	Header3	Header4	Header5	Header6	Header7	Header8	Header9	Header10
Column 1	Column 2	Vertical column span
Horizontal Span

A List Table

Frozen Delights!

Treat	Quantity	Description
Albatross	2.99	On a stick!
Crunchy Frog	1.49	If we took the bones out, it wouldn’t be crunchy, now would it?
Gannet Ripple	1.99	On a stick!

---

Container Styles

These are styles applied to the rest container directive

This text is in TextNotes.This is some standard body text. It is just here to bulk out this section so I can see how it looks. I have nothing to say, I am just rambling on about nothing important. How much text should I write? Not really got a clue. Having a wide screen means I am struggling to get two lines of text at the moment. I can only hope that on a more confined page layout this wraps round into about 4-5 lines.

This text is in TextNotesLight.This is some standard body text. It is just here to bulk out this section so I can see how it looks. I have nothing to say, I am just rambling on about nothing important. How much text should I write? Not really got a clue. Having a wide screen means I am struggling to get two lines of text at the moment. I can only hope that on a more confined page layout this wraps round into about 4-5 lines.

This text is in TextNotesMid.This is some standard body text. It is just here to bulk out this section so I can see how it looks. I have nothing to say, I am just rambling on about nothing important. How much text should I write? Not really got a clue. Having a wide screen means I am struggling to get two lines of text at the moment. I can only hope that on a more confined page layout this wraps round into about 4-5 lines.

This text is in TextNotesLSide.This is some standard body text. It is just here to bulk out this section so I can see how it looks. I have nothing to say, I am just rambling on about nothing important. How much text should I write? Not really got a clue. Having a wide screen means I am struggling to get two lines of text at the moment. I can only hope that on a more confined page layout this wraps round into about 4-5 lines.

This text is in TextNotesRSide.This is some standard body text. It is just here to bulk out this section so I can see how it looks. I have nothing to say, I am just rambling on about nothing important. How much text should I write? Not really got a clue. Having a wide screen means I am struggling to get two lines of text at the moment. I can only hope that on a more confined page layout this wraps round into about 4-5 lines.

---

This is an embedded image file aligned right

This is another embedded image file

---

This is a line of text

Indirect Hyperlinks

This link DOES NOT use an indirect hyperlink

Formiko Homepage

These links DO use indirect hyperlinks

ReText Homepage

Formiko Homepage

Document Links

Add a link to another document with the “View Guide” text link. View Guide

Add a link to another document with the page title “Elog” as the text link. Elog