Sample document from the Gnome Guides to test the Asciidoctor Mallard backend

shell-introduction.adoc.txt

= Introduction to GNOME
Shaun McCance <shaunm@gnome.org>; Michael Hill <mdhillca@gmail.com>; Ekaterina Gerasimova <kittykat3756@gmail.com>
v3.13.92, 2014-09-22
:experimental:
:category: ui
:description: pass:macros[A visual introduction to your desktop, the top bar, and the btn:[Activities] overview.]
:imagesdir: figures
:toc: preamble

GNOME 3 features a completely reimagined user interface designed to stay out of your way, minimize distractions, and help you get things done.
When you first log in, you will see an empty desktop and the top bar.

image::shell-top-bar.png[GNOME shell top bar,600]

The top bar provides access to your windows and applications, your calendar and appointments, and <<status-icons,system properties>> like sound, networking, and power.
In the status menu in the top bar, you can change the volume or screen brightness, edit your [gui]_Wi-Fi_ connection details, check your battery status, log out or switch users, and turn off your computer.

[#activities]
== btn:[Activities] overview

image::shell-activities.png[Activities button,123,82,float=right]

To access your windows and applications, click the btn:[Activities] button, or just move your mouse pointer to the top-left hot corner.
You can also press the kbd:[Super] key on your keyboard.
You can see your windows and applications in the overview.
You can also just start typing to search your applications, files, folders and the web.

image::shell-dash.png[The dash,49,300,float=left]

On the left of the overview, you will find the _dash_.
The dash shows you your favorite and running applications.
Click any icon in the dash to open that application;
if the application is already running, it will be highlighted.
Clicking its icon will bring up the most recently used window.
You can also drag the icon to the overview, or onto any workspace on the right.

Right-clicking the icon displays a menu that allows you to pick any window in a running application, or to open a new window.
You can also click the icon while holding down kbd:[Ctrl] to open a new window.

When you enter the overview, you will initially be in the windows overview.
This shows you live thumbnails of all the windows on the current workspace.

Click the grid button at the bottom of the dash to display the applications overview.
This shows you all the applications installed on your computer.
Click any application to run it, or drag an application to the overview or onto a workspace thumbnail.
You can also drag an application onto the dash to make it a favorite.
Your favorite applications stay in the dash even when they’re not running, so you can access them quickly.

[%compact]
* <<shell-apps-open,Learn more about starting applications.>>
* <<shell-windows,Learn more about windows and workspaces.>>

[#appmenu]
== Application menu

image::shell-appmenu-shell.png[App Menu of Terminal,250,float=right]

Application menu, located beside the btn:[Activities] button, shows the name of the active application alongside with its icon and provides quick access to application preferences or help.
The items that are available in the application menu vary depending on the application.

[#clock]
== Clock, calendar & appointments

image::shell-appts.png["Clock, calendar, and appointments",250,float=right]

Click the clock on the top bar to see the current date, a month-by-month calendar, and a list of your upcoming appointments.
You can also access the date and time settings and open your full [app]_Evolution_ calendar directly from the menu.

[%compact]
* <<clock-calendar,Learn more about the calendar and appointments.>>

[#yourname]
== You and your computer

image::shell-exit.png[User menu,250,float=right]

Click the system menu in the top-right corner to manage your system settings and your computer.

When you leave your computer, you can lock your screen to prevent other people from using it.
You can also quickly switch users without logging out completely to give somebody else access to the computer, or you can suspend or power off the computer from the menu.

[%compact]
* <<shell-exit,Learn more about switching users, logging out, and turning off your computer.>>

[#lockscreen]
== Lock Screen

image::shell-lock.png[Lock Screen,250,float=right]

When you lock your screen, or it locks automatically, the lock screen is displayed.
In addition to protecting your desktop while you’re away from your computer, the lock screen displays the date and time.
It also shows information about your battery and network status, and allows you to control media playback.

[%compact]
* <<shell-lockscreen,Learn more about the lock screen.>>

[#message-tray]
== Message Tray

image::shell-message-tray.png[Message tray,600]

The message tray can be brought into view by pushing your mouse pointer against the bottom of the screen or by pressing kbd:[Super+M].
This is where your notifications are stored until you are ready to view them.

[%compact]
* <<shell-notifications,Learn more about notifications and the message tray.>>

[#window-list]
== Window List

GNOME features a different approach to switching windows than a permanently visible window list found in other desktop environments.
This lets you focus on the task at hand without distractions.

[%compact]
* <<shell-windows-switching,Learn more about switching windows.>>

shell-introduction.page

<?xml version="1.0" encoding="UTF-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" xml:lang="en" type="topic" style="ui" id="expected-shell-introduction">
<info>
<revision version="3.13.92" date="2014-09-22"/>
<credit type="author">
<name>Shaun McCance</name>
<email>shaunm@gnome.org</email>
</credit>
<credit type="author">
<name>Michael Hill</name>
<email>mdhillca@gmail.com</email>
</credit>
<credit type="author">
<name>Ekaterina Gerasimova</name>
<email>kittykat3756@gmail.com</email>
</credit>
<desc>A visual introduction to your desktop, the top bar, and the <gui style="button">Activities</gui> overview.</desc>
</info>
<title>Introduction to GNOME</title>
<p>GNOME 3 features a completely reimagined user interface designed to stay out of your way, minimize distractions, and help you get things done.
When you first log in, you will see an empty desktop and the top bar.</p>
<media type="image" src="figures/shell-top-bar.png" width="600">
<p>GNOME shell top bar</p>
</media>
<p>The top bar provides access to your windows and applications, your calendar and appointments, and <link xref="status-icons">system properties</link> like sound, networking, and power.
In the status menu in the top bar, you can change the volume or screen brightness, edit your <gui>Wi-Fi</gui> connection details, check your battery status, log out or switch users, and turn off your computer.</p>
<links type="section"/>
<section id="activities">
<title><gui style="button">Activities</gui> overview</title>
<media type="image" src="figures/shell-activities.png" width="123" height="82" style="floatend floatright">
<p>Activities button</p>
</media>
<p>To access your windows and applications, click the <gui style="button">Activities</gui> button, or just move your mouse pointer to the top-left hot corner.
You can also press the <key>Super</key> key on your keyboard.
You can see your windows and applications in the overview.
You can also just start typing to search your applications, files, folders and the web.</p>
<media type="image" src="figures/shell-dash.png" width="49" height="300" style="floatstart floatleft">
<p>The dash</p>
</media>
<p>On the left of the overview, you will find the <em>dash</em>.
The dash shows you your favorite and running applications.
Click any icon in the dash to open that application;
if the application is already running, it will be highlighted.
Clicking its icon will bring up the most recently used window.
You can also drag the icon to the overview, or onto any workspace on the right.</p>
<p>Right-clicking the icon displays a menu that allows you to pick any window in a running application, or to open a new window.
You can also click the icon while holding down <key>Ctrl</key> to open a new window.</p>
<p>When you enter the overview, you will initially be in the windows overview.
This shows you live thumbnails of all the windows on the current workspace.</p>
<p>Click the grid button at the bottom of the dash to display the applications overview.
This shows you all the applications installed on your computer.
Click any application to run it, or drag an application to the overview or onto a workspace thumbnail.
You can also drag an application onto the dash to make it a favorite.
Your favorite applications stay in the dash even when they’re not running, so you can access them quickly.</p>
<list style="compact">
<item>
<p><link xref="shell-apps-open">Learn more about starting applications.</link></p>
</item>
<item>
<p><link xref="shell-windows">Learn more about windows and workspaces.</link></p>
</item>
</list>
</section>
<section id="appmenu">
<title>Application menu</title>
<media type="image" src="figures/shell-appmenu-shell.png" width="250" style="floatend floatright">
<p>App Menu of Terminal</p>
</media>
<p>Application menu, located beside the <gui style="button">Activities</gui> button, shows the name of the active application alongside with its icon and provides quick access to application preferences or help.
The items that are available in the application menu vary depending on the application.</p>
</section>
<section id="clock">
<title>Clock, calendar &amp; appointments</title>
<media type="image" src="figures/shell-appts.png" width="250" style="floatend floatright">
<p>Clock, calendar, and appointments</p>
</media>
<p>Click the clock on the top bar to see the current date, a month-by-month calendar, and a list of your upcoming appointments.
You can also access the date and time settings and open your full <app>Evolution</app> calendar directly from the menu.</p>
<list style="compact">
<item>
<p><link xref="clock-calendar">Learn more about the calendar and appointments.</link></p>
</item>
</list>
</section>
<section id="yourname">
<title>You and your computer</title>
<media type="image" src="figures/shell-exit.png" width="250" style="floatend floatright">
<p>User menu</p>
</media>
<p>Click the system menu in the top-right corner to manage your system settings and your computer.</p>
<p>When you leave your computer, you can lock your screen to prevent other people from using it.
You can also quickly switch users without logging out completely to give somebody else access to the computer, or you can suspend or power off the computer from the menu.</p>
<list style="compact">
<item>
<p><link xref="shell-exit">Learn more about switching users, logging out, and turning off your computer.</link></p>
</item>
</list>
</section>
<section id="lockscreen">
<title>Lock Screen</title>
<media type="image" src="figures/shell-lock.png" width="250" style="floatend floatright">
<p>Lock Screen</p>
</media>
<p>When you lock your screen, or it locks automatically, the lock screen is displayed.
In addition to protecting your desktop while you’re away from your computer, the lock screen displays the date and time.
It also shows information about your battery and network status, and allows you to control media playback.</p>
<list style="compact">
<item>
<p><link xref="shell-lockscreen">Learn more about the lock screen.</link></p>
</item>
</list>
</section>
<section id="message-tray">
<title>Message Tray</title>
<media type="image" src="figures/shell-message-tray.png" width="600">
<p>Message tray</p>
</media>
<p>The message tray can be brought into view by pushing your mouse pointer against the bottom of the screen or by pressing <keyseq><key>Super</key><key>M</key></keyseq>.
This is where your notifications are stored until you are ready to view them.</p>
<list style="compact">
<item>
<p><link xref="shell-notifications">Learn more about notifications and the message tray.</link></p>
</item>
</list>
</section>
<section id="window-list">
<title>Window List</title>
<p>GNOME features a different approach to switching windows than a permanently visible window list found in other desktop environments.
This lets you focus on the task at hand without distractions.</p>
<list style="compact">
<item>
<p><link xref="shell-windows-switching">Learn more about switching windows.</link></p>
</item>
</list>
</section>
</page>