.. role::  raw-html(raw)
    :format: html

.. |rocket-icon| replace:: :raw-html:`<svg style="width: 1.2rem;rotate: 315deg;" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 640 512"><!--!Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2024 Fonticons, Inc.--><path fill="#0f418e" d="M130 480c40.6 0 80.4-11 115.2-31.9L352 384l-224 0 0 96h2zM352 128L245.2 63.9C210.4 43 170.6 32 130 32h-2v96l224 0zM96 128l0-96H80C53.5 32 32 53.5 32 80v48h8c-22.1 0-40 17.9-40 40v16V328v16c0 22.1 17.9 40 40 40H32v48c0 26.5 21.5 48 48 48H96l0-96h8c26.2 0 49.4-12.6 64-32H456c69.3 0 135-22.7 179.2-81.6c6.4-8.5 6.4-20.3 0-28.8C591 182.7 525.3 160 456 160H168c-14.6-19.4-37.8-32-64-32l-8 0zM512 243.6v24.9c0 19.6-15.9 35.6-35.6 35.6c-2.5 0-4.4-2-4.4-4.4V212.4c0-2.5 2-4.4 4.4-4.4c19.6 0 35.6 15.9 35.6 35.6z"/></svg>`

.. _quick_start:

###########################
Quick Start
###########################
Is this your first time on the **LEXIS Platform**?
Then this is the great place to quickly learn
what's what and where's where. This guide will
get you through the basics quickly and rocket
fast |rocket-icon| guide you through the initial
steps of using the **LEXIS Platform** via the web portal.

========
Log in
========

Before even getting to the `portal <https://portal.lexis.tech>`_,
you are required to log in to your user account.
And before even logging in, we kindly ask you to accept our cookies.
**The login button can be found on the right side**
of the landing page.

.. image:: img/quickstart/landing_page.png
   :align: center
   :alt: Landing page

You will be presented with various login options.
You most likely want to use `MyAccessID <https://wiki.geant.org/display/MyAccessID/MyAccessID+Home>`_
*(eduGAIN, eIDAS)*, as this is the most common login method.
There are other options, but unless you were specifically told to use them,
the recommended method should do.

.. image:: img/quickstart/log_into_options.png
   :width: 600
   :align: center
   :alt: Login in application

================
Look around
================

So the login worked, great. Before you lies the
**LEXIS Platform**. There are four important sections.

1. Main display area
2. Main menu
3. Project filters
4. Your personal space

.. image:: img/quickstart/areas.png
   :align: center
   :alt: Four regions for conquest

We could extensively describe every nook and cranny
of what you can see, but why not use our built-in
guided tour to do just that? Simply click on the
avatar icon inside your personal space area and
choose *Show Guide*.

.. image:: img/quickstart/fsteps_show_guide.png
   :width: 240
   :align: center
   :alt: Open guided tour in web application

================
Make it your own
================

So now you know where to find things. That's certainly awesome,
but what if you don't like the blue colour? What if the chosen
font type makes your eye twitch? Worry not, for you can
customise it to your liking. Remember where you could find
the *Show Guide*? Above it is the *Theme Settings*. Here you
can choose your preffered colour and font and switch the
light mode. Be sure to make the *LEXIS Portal* to your liking as you will
certainly be spending a lot of time here.

.. image:: img/quickstart/fsteps_show_themes.png
   :width: 240
   :align: center
   :alt: What to choose

================
Where to next
================

Congratulations! You successfully completed your first
steps inside the *LEXIS Platform*. But what now, you wonder?
Now is the time to use it for its intended purpose: to easily
access enormous computing power. However, this is way
beyond the scope of this swift introduction, so we
rather give you some pointers as where to go next.

Are you trying to join a project? Do you need to upload a dataset?
Not sure how to make a workflow from a job script and
execute it on a cluster? Everything you can do
on the **LEXIS Platform** is described in detail in :ref:`howto_guide`.

Do you want to create a container and immediately
send it to cluster? We have complete tutorial on running
your own :ref:`container_workflow`.

Are you a *DSpace* user who wants to link his dataset
into the **LEXIS Platform**? We can show you how
to quickly connect your :ref:`dspace`.