Metadata-Version: 2.1
Name: skyline-console
Version: 2.0.1.dev2
Summary: OpenStack Skyline Console
Home-page: https://docs.openstack.org/skyline-console/latest/
Author: OpenStack
Author-email: openstack-discuss@lists.openstack.org
Project-URL: Source, https://opendev.org/openstack/skyline-console
Project-URL: Tracker, https://bugs.launchpad.net/skyline-console
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.8
License-File: LICENSE

Instructions
============

`简体中文 <./README.zh_CN.rst>`__\ \| English

**Table of contents**

-  `Instructions <#instructions>`__

   -  `Resources <#resources>`__
   -  `Prerequisites <#prerequisites>`__
   -  `Local Environment <#local-environment>`__
   -  `Usage <#usage>`__
   -  `Docs <#docs>`__

      -  `How to develop <#how-to-develop>`__
      -  `How to test <#how-to-test>`__

Resources
---------

-  `Wiki <https://wiki.openstack.org/wiki/Skyline>`__
-  `Bug Tracker <https://launchpad.net/skyline-console>`__

Prerequisites
-------------

-  ``node``: lts/erbium (v12.*)
-  ``yarn``: 1.22.4 +

Local Environment
-----------------

Take CentOS as an example

-  Install nvm ( version control system for nodejs )

   .. code:: shell

      wget -P /root/ --tries=10 --retry-connrefused --waitretry=60 --no-dns-cache --no-cache  https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh
      bash /root/install.sh
      . /root/.nvm/nvm.sh

-  Install nodejs

   .. code:: shell

      NODE_VERSION=erbium
      nvm install --lts=$NODE_VERSION
      nvm alias default lts/$NODE_VERSION
      nvm use default

-  Verify nodejs and npm versions

   .. code:: shell

      node -v
      # v12.*.*
      npm -v
      # 6.*.*

-  Install yarn

   .. code:: shell

      npm install -g yarn

-  Install the project dependency under the root directory, with
   ``package.json`` in the same place.

   .. code:: shell

      yarn install

   After those steps, please just wait until the installation is
   complete.

Usage
-----

Under the root directory, with ``package.json`` in the same place.

-  ``yarn run mock``: Use the mock interface of
   `rap2 <http://rap2.taobao.org/>`__
-  ``yarn run dev``: To use the actual interface, please change the
   "http://pre.xxx.com" in line 47 into the real address in file
   ``webpack.dev.js``.
-  ``yarn run build``: Build packages and then you can hand over the
   contents of the generated *dist* directory to the back end.

Docs
----

How to develop
~~~~~~~~~~~~~~

-  `Preparation before
   development <docs/en/develop/1-ready-to-work.md>`__
-  `Directory structure <docs/en/develop/2-catalog-introduction.md>`__
-  `Develop a new resource
   page <docs/en/develop/3-0-how-to-develop.md>`__
-  `BaseList
   introduction <docs/en/develop/3-1-BaseList-introduction.md>`__
-  `BaseTabList
   introduction <docs/en/develop/3-2-BaseTabList-introduction.md>`__
-  `BaseDetail
   introduction <docs/en/develop/3-3-BaseDetail-introduction.md>`__
-  `BaseDetailInfo
   introduction <docs/en/develop/3-4-BaseDetailInfo-introduction.md>`__
-  `BaseStore
   introduction <docs/en/develop/3-5-BaseStore-introduction.md>`__
-  `FormAction
   introduction <docs/en/develop/3-6-FormAction-introduction.md>`__
-  `ModalAction
   introduction <docs/en/develop/3-7-ModalAction-introduction.md>`__
-  `ConfirmAction
   introduction <docs/en/develop/3-8-ConfirmAction-introduction.md>`__
-  `StepAction
   introduction <docs/en/develop/3-9-StepAction-introduction.md>`__
-  `FormItem
   introduction <docs/en/develop/3-10-FormItem-introduction.md>`__
-  `Action introduction <docs/en/develop/3-11-Action-introduction.md>`__
-  `Menu introduction <docs/en/develop/3-12-Menu-introduction.md>`__
-  `Route introduction <docs/en/develop/3-13-Route-introduction.md>`__
-  `I18n introduction <docs/en/develop/3-14-I18n-introduction.md>`__

How to test
~~~~~~~~~~~

-  `Two kinds of tests <docs/en/test/1-ready-to-work.md>`__
-  `Directory structure <docs/en/test/2-catalog-introduction.md>`__
-  `How to edit e2e case <docs/en/test/3-0-how-to-edit-e2e-case.md>`__
-  `E2E - Form operation <docs/en/test/3-1-E2E-form-operation.md>`__
-  `E2E - Table operation <docs/en/test/3-2-E2E-table-operation.md>`__
-  `E2E - Detail operation <docs/en/test/3-3-E2E-detail-operation.md>`__
-  `E2E - Resource
   operation <docs/en/test/3-4-E2E-resource-operation.md>`__

