tobago-example/tobago-example-demo/src/main/webapp/content/10-intro/Intro.xhtml

<?xml version="1.0" encoding="UTF-8"?>

<!--
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
-->

<ui:composition template="/main.xhtml"
                xmlns="http://www.w3.org/1999/xhtml"
                xmlns:tc="http://myfaces.apache.org/tobago/component"
                xmlns:ui="http://java.sun.com/jsf/facelets">
  <p>This is the demo of Tobago.
    It shows the components and concepts of Tobago and is also a main part of the documentation.</p>
  <p>If you want to migrate from an older version, you'll find further information in the
    <tc:link label="migration guide" outcome="/content/10-intro/50-migration/Migration.xhtml"/>.</p>
  <p>If you want to start this demo on you local machine, have a look at the section 'Local Demo'.</p>
  <tc:section label="Description">
    <p>Tobago is a user interface framework for developing web applications.
      The technical basis of the framework is JavaServer Faces. The main core represents a theme oriented
      JSF Render Kit.</p>
    <tc:section label="Basic Controls">
      <p>Tobago provides all standard controls of HTML like inputs, textareas, radiobuttons, checkboxes and buttons.
        Additionally Tobago provides you with complex controls, which are not natively supported by simple HTML,
        including sheets, trees and tabs.</p>
    </tc:section>
    <tc:section label="Validation">
      <p>The main goal of Tobago is the development of applications which are interactive from the users point of view.
        Tobago makes it easy to validate input and helps the user to enter correct data.</p>
    </tc:section>
    <tc:section label="Layout">
      <p>Tobago provides several advanced layout managers to fit for specific use cases by using CSS3 and HTML5.
        This includes a 12 columns layout from <tc:link label="Bootstrap" link="https://getbootstrap.com/"/>
        and a flex layout which replace the old grid layout from Tobago 2.</p>
    </tc:section>
    <tc:section label="Versioning">
      <p>The Tobago project is using <tc:link label="semantic versioning" link="https://semver.org/"/> since past 2016.</p>
      <p>This will lead into more growing minor version number compared to the past.</p>
    </tc:section>
  </tc:section>

  <tc:section label="Local Demo">
    <p>In case that this demo already runs on your local machine,
      you can follow the link to the
      <tc:link label="public demo" link="http://tobago-vm.apache.org/"/>.</p>
    <p>If this is the public demo and you want to build it on your own, read the following instructions.</p>
    <tc:section label="Instructions">
      <p>First of all you need
        <tc:link label="Maven" link="https://maven.apache.org/"/> (at least version 3.0.4) and
        <tc:link label="Java SE 8" link="http://www.oracle.com/technetwork/java/javase/downloads/"/> or higher.</p>
      <p>After that, check out the source code from subversion repository.
        <br/>
        <code>git clone https://github.com/apache/myfaces-tobago</code>
        <br/>
        Alternatively you can get the source code from the
        <tc:link label="download section" link="https://myfaces.apache.org/tobago/download.html"/>.</p>
      <p>Go to the tobago3 directory, and build Tobago with <code>mvn install</code>.</p>
      <p>Go to 'tobago3/tobago-example/tobago-example-demo' and start the demo with <code>mvn jetty:run</code>.</p>
    </tc:section>
  </tc:section>
</ui:composition>