Article Conventions

Details
Category: Other

User Rating: 5 / 5

Star ActiveStar ActiveStar ActiveStar ActiveStar Active
 

UxOra articles use several writing conventions to highlight certain parts or to draw attention to specific information.

I hope theses conventions will make articles more readable.

SQL command line

-- This is a sql comment
-- The following will show a sql command and its output

SQL> SELECT 'A SQL command test' TEST FROM dual ;

/*__OUTPUT__
TEST
------------------------------
A SQL command test ...
__OUTPUT__*/

[SYS@SID]> SELECT 'A 2nd SQL command test' TEST2 FROM dual ;

    TEST2
    ------------------------------
    A 2nd SQL command test ...

Unix command line

# This is a Unix shell comment
# The following will show an unix command and its output.

[user]$ echo "this is a unix cmd line test"

<<__OUTPUT__
this is a unix cmd line test
__OUTPUT__

[user@oralab01]$ echo "this is a 2nd unix cmd line test"

    this is a unix cmd line test

Code Content Block

-- Sample of sql script code
SET VERIFY OFF ;
SET FEED OFF ;
SET ECHO OFF ;
SET PAGES 0 ;
SET LINES 128 ;
COLUMN SqlCmd FORMAT A120 WORD_WRAPPED ;
SPOOL HelloWorld.sql
SELECT 'Hello World!!' Test FROM DUAL ;
SPOOL OFF ;

Text Content Block

A Former Life by Charles Baudelaire:

LONG since, I lived beneath vast porticoes,
By many ocean-sunsets tinged and fired,
Where mighty pillars, in majestic rows,
Seemed like basaltic caves when day expired.

The rolling surge that mirrored all the skies
Mingled its music, turbulent and rich,
Solemn and mystic, with the colours which
The setting sun reflected in my eyes.

And there I lived amid voluptuous calms,
In splendours of blue sky and wandering wave,
Tended by many a naked, perfumed slave,

Who fanned my languid brow with waving palms.
They were my slaves--the only care they had
To know what secret grief had made me sad.

Quotes

The world is a dangerous place to live; not because of the people who are evil, but because of the people who don't do anything about it.

by Albert Einstein

Notes and Warnings

Note
A note is a tip or shortcut or alternative approach to the task at hand. Ignoring a note should have no negative consequences, but you might miss out on a trick that makes your life easier.

Important
Important boxes detail things that are easily missed. Ignoring important boxes won''t cause data loss but may cause irritation and frustration.

Warning
A Warning should not be ignored. Ignoring warnings will most likely cause data loss.

Others informational content

Reference/Related articles
Reference or related article on the same subject.

Work in progress ...
Article is still in work, some additional content will probably be added later on.