From e4ffc495c64172aba9a542cd9ac3c0620cbf9c61 Mon Sep 17 00:00:00 2001 From: Kristal Dale Date: Mon, 24 Sep 2018 15:21:42 -0700 Subject: [PATCH] Reorg of WordPress tutorial (and related) files, to correct their placement in the tutorials nav section. Changes include: - Move all WordPress tutorial files into WordPress folder (landing page, web server install, wp-install, and related images) - Update WP landing page to more clearly indicate child pages of tutorial, hide toctree - All files related to WordPress tutorial: replace CLOSIA with CL-ATTRs, correct attributions - grammar Signed-off-by: Kristal Dale --- source/clear-linux/tutorials/tutorials.rst | 12 ++-- source/clear-linux/tutorials/wordpress.rst | 27 --------- .../figures/web-server-install-1.png | Bin .../figures/web-server-install-2.png | Bin .../figures/web-server-install-3.png | Bin .../figures/web-server-install-4.png | Bin .../figures/web-server-install-5.png | Bin .../figures/web-server-install-6.png | Bin .../figures/web-server-install-7.png | Bin .../figures/web-server-install-8.png | Bin .../figures/wp-install-1.png | Bin .../figures/wp-install-2.png | Bin .../figures/wp-install-3.png | Bin .../figures/wp-install-4.png | Bin .../figures/wp-install-5.png | Bin .../figures/wp-install-6.png | Bin .../figures/wp-install-7.png | Bin .../figures/wp-install-8.png | Bin .../web-server-install.rst | 13 +++-- .../tutorials/wordpress/wordpress.rst | 32 +++++++++++ .../{wp-install => wordpress}/wp-install.rst | 54 +++++++++++++----- 21 files changed, 85 insertions(+), 53 deletions(-) delete mode 100644 source/clear-linux/tutorials/wordpress.rst rename source/clear-linux/tutorials/{web-server-install => wordpress}/figures/web-server-install-1.png (100%) rename source/clear-linux/tutorials/{web-server-install => wordpress}/figures/web-server-install-2.png (100%) rename source/clear-linux/tutorials/{web-server-install => wordpress}/figures/web-server-install-3.png (100%) rename source/clear-linux/tutorials/{web-server-install => wordpress}/figures/web-server-install-4.png (100%) rename source/clear-linux/tutorials/{web-server-install => wordpress}/figures/web-server-install-5.png (100%) rename source/clear-linux/tutorials/{web-server-install => wordpress}/figures/web-server-install-6.png (100%) rename source/clear-linux/tutorials/{web-server-install => wordpress}/figures/web-server-install-7.png (100%) rename source/clear-linux/tutorials/{web-server-install => wordpress}/figures/web-server-install-8.png (100%) rename source/clear-linux/tutorials/{wp-install => wordpress}/figures/wp-install-1.png (100%) rename source/clear-linux/tutorials/{wp-install => wordpress}/figures/wp-install-2.png (100%) rename source/clear-linux/tutorials/{wp-install => wordpress}/figures/wp-install-3.png (100%) rename source/clear-linux/tutorials/{wp-install => wordpress}/figures/wp-install-4.png (100%) rename source/clear-linux/tutorials/{wp-install => wordpress}/figures/wp-install-5.png (100%) rename source/clear-linux/tutorials/{wp-install => wordpress}/figures/wp-install-6.png (100%) rename source/clear-linux/tutorials/{wp-install => wordpress}/figures/wp-install-7.png (100%) rename source/clear-linux/tutorials/{wp-install => wordpress}/figures/wp-install-8.png (100%) rename source/clear-linux/tutorials/{web-server-install => wordpress}/web-server-install.rst (96%) create mode 100644 source/clear-linux/tutorials/wordpress/wordpress.rst rename source/clear-linux/tutorials/{wp-install => wordpress}/wp-install.rst (72%) diff --git a/source/clear-linux/tutorials/tutorials.rst b/source/clear-linux/tutorials/tutorials.rst index c312c8ad..91dbdb4d 100644 --- a/source/clear-linux/tutorials/tutorials.rst +++ b/source/clear-linux/tutorials/tutorials.rst @@ -5,18 +5,18 @@ Tutorials Our Tutorials: -* Demonstrate how to use |CL| features for cloud, client, distributed - processing, and virtual environments -* Involve specific application of |CL| that often use third-party tools -* Extend the development possibilities of |CL| with specific use cases +* demonstrate how to use |CL-ATTR| features for cloud, client, distributed + processing, and virtual environments. +* involve specific application of |CL| that often use third-party tools. +* extend the development possibilities of |CL| with specific use cases. This section provides detailed instructions to guide you through completing -specific |CLOSIA| use cases. +specific |CL| use cases. .. toctree:: :maxdepth: 2 - wordpress + wordpress/wordpress flatpak/flatpak machine-learning/machine-learning docker/docker diff --git a/source/clear-linux/tutorials/wordpress.rst b/source/clear-linux/tutorials/wordpress.rst deleted file mode 100644 index f66bb1f6..00000000 --- a/source/clear-linux/tutorials/wordpress.rst +++ /dev/null @@ -1,27 +0,0 @@ -.. _wordpress: - -WordPress\* use case tutorial -############################# - -Welcome to our WordPress use case tutorial. The objective of the tutorial is -to guide you to a fully realized WordPress website using |CLOSIA|. - -In this tutorial we assume your system is already running |CL|. For -instructions on how to install |CL| on bare metal, see the -:ref:`bare metal install` page from our -:ref:`get-started` guide. For your convenience, we have -split this tutorial in two different sections. If you already have a |CL| -based :abbr:`LAMP (Linux, Apache, MySQL, PHP)` web server you can skip ahead -to the WordPress tutorial. - -.. toctree:: - :maxdepth: 1 - - web-server-install/web-server-install.rst - wp-install/wp-install.rst - -.. note:: - - This tutorial is for development and testing purposes only. Additional - steps are required to secure production systems. - Those steps are beyond the scope of this tutorial. diff --git a/source/clear-linux/tutorials/web-server-install/figures/web-server-install-1.png b/source/clear-linux/tutorials/wordpress/figures/web-server-install-1.png similarity index 100% rename from source/clear-linux/tutorials/web-server-install/figures/web-server-install-1.png rename to source/clear-linux/tutorials/wordpress/figures/web-server-install-1.png diff --git a/source/clear-linux/tutorials/web-server-install/figures/web-server-install-2.png b/source/clear-linux/tutorials/wordpress/figures/web-server-install-2.png similarity index 100% rename from source/clear-linux/tutorials/web-server-install/figures/web-server-install-2.png rename to source/clear-linux/tutorials/wordpress/figures/web-server-install-2.png diff --git a/source/clear-linux/tutorials/web-server-install/figures/web-server-install-3.png b/source/clear-linux/tutorials/wordpress/figures/web-server-install-3.png similarity index 100% rename from source/clear-linux/tutorials/web-server-install/figures/web-server-install-3.png rename to source/clear-linux/tutorials/wordpress/figures/web-server-install-3.png diff --git a/source/clear-linux/tutorials/web-server-install/figures/web-server-install-4.png b/source/clear-linux/tutorials/wordpress/figures/web-server-install-4.png similarity index 100% rename from source/clear-linux/tutorials/web-server-install/figures/web-server-install-4.png rename to source/clear-linux/tutorials/wordpress/figures/web-server-install-4.png diff --git a/source/clear-linux/tutorials/web-server-install/figures/web-server-install-5.png b/source/clear-linux/tutorials/wordpress/figures/web-server-install-5.png similarity index 100% rename from source/clear-linux/tutorials/web-server-install/figures/web-server-install-5.png rename to source/clear-linux/tutorials/wordpress/figures/web-server-install-5.png diff --git a/source/clear-linux/tutorials/web-server-install/figures/web-server-install-6.png b/source/clear-linux/tutorials/wordpress/figures/web-server-install-6.png similarity index 100% rename from source/clear-linux/tutorials/web-server-install/figures/web-server-install-6.png rename to source/clear-linux/tutorials/wordpress/figures/web-server-install-6.png diff --git a/source/clear-linux/tutorials/web-server-install/figures/web-server-install-7.png b/source/clear-linux/tutorials/wordpress/figures/web-server-install-7.png similarity index 100% rename from source/clear-linux/tutorials/web-server-install/figures/web-server-install-7.png rename to source/clear-linux/tutorials/wordpress/figures/web-server-install-7.png diff --git a/source/clear-linux/tutorials/web-server-install/figures/web-server-install-8.png b/source/clear-linux/tutorials/wordpress/figures/web-server-install-8.png similarity index 100% rename from source/clear-linux/tutorials/web-server-install/figures/web-server-install-8.png rename to source/clear-linux/tutorials/wordpress/figures/web-server-install-8.png diff --git a/source/clear-linux/tutorials/wp-install/figures/wp-install-1.png b/source/clear-linux/tutorials/wordpress/figures/wp-install-1.png similarity index 100% rename from source/clear-linux/tutorials/wp-install/figures/wp-install-1.png rename to source/clear-linux/tutorials/wordpress/figures/wp-install-1.png diff --git a/source/clear-linux/tutorials/wp-install/figures/wp-install-2.png b/source/clear-linux/tutorials/wordpress/figures/wp-install-2.png similarity index 100% rename from source/clear-linux/tutorials/wp-install/figures/wp-install-2.png rename to source/clear-linux/tutorials/wordpress/figures/wp-install-2.png diff --git a/source/clear-linux/tutorials/wp-install/figures/wp-install-3.png b/source/clear-linux/tutorials/wordpress/figures/wp-install-3.png similarity index 100% rename from source/clear-linux/tutorials/wp-install/figures/wp-install-3.png rename to source/clear-linux/tutorials/wordpress/figures/wp-install-3.png diff --git a/source/clear-linux/tutorials/wp-install/figures/wp-install-4.png b/source/clear-linux/tutorials/wordpress/figures/wp-install-4.png similarity index 100% rename from source/clear-linux/tutorials/wp-install/figures/wp-install-4.png rename to source/clear-linux/tutorials/wordpress/figures/wp-install-4.png diff --git a/source/clear-linux/tutorials/wp-install/figures/wp-install-5.png b/source/clear-linux/tutorials/wordpress/figures/wp-install-5.png similarity index 100% rename from source/clear-linux/tutorials/wp-install/figures/wp-install-5.png rename to source/clear-linux/tutorials/wordpress/figures/wp-install-5.png diff --git a/source/clear-linux/tutorials/wp-install/figures/wp-install-6.png b/source/clear-linux/tutorials/wordpress/figures/wp-install-6.png similarity index 100% rename from source/clear-linux/tutorials/wp-install/figures/wp-install-6.png rename to source/clear-linux/tutorials/wordpress/figures/wp-install-6.png diff --git a/source/clear-linux/tutorials/wp-install/figures/wp-install-7.png b/source/clear-linux/tutorials/wordpress/figures/wp-install-7.png similarity index 100% rename from source/clear-linux/tutorials/wp-install/figures/wp-install-7.png rename to source/clear-linux/tutorials/wordpress/figures/wp-install-7.png diff --git a/source/clear-linux/tutorials/wp-install/figures/wp-install-8.png b/source/clear-linux/tutorials/wordpress/figures/wp-install-8.png similarity index 100% rename from source/clear-linux/tutorials/wp-install/figures/wp-install-8.png rename to source/clear-linux/tutorials/wordpress/figures/wp-install-8.png diff --git a/source/clear-linux/tutorials/web-server-install/web-server-install.rst b/source/clear-linux/tutorials/wordpress/web-server-install.rst similarity index 96% rename from source/clear-linux/tutorials/web-server-install/web-server-install.rst rename to source/clear-linux/tutorials/wordpress/web-server-install.rst index 24793b97..959c515c 100644 --- a/source/clear-linux/tutorials/web-server-install/web-server-install.rst +++ b/source/clear-linux/tutorials/wordpress/web-server-install.rst @@ -1,9 +1,10 @@ .. _web-server-install: -Create a Clear Linux\* based web server +Create a |CL-ATTR| based web server ####################################### -This tutorial shows you how to create a LAMP server using |CL-ATTR| and how to use phpMyAdmin\* to manage an associated database. +This tutorial shows you how to create a :abbr:`LAMP (Linux, Apache, MySQL, PHP)` server using |CL-ATTR| and how to use +phpMyAdmin\* to manage an associated database. In order to create a web server using |CL| as the host OS, your host system must be running |CL|. This tutorial assumes you have successfully installed @@ -18,7 +19,9 @@ Before you install new packages, update the |CL| OS with the following console c Create a LAMP Server ******************** -A LAMP server uses Linux\*, Apache\*, MySQL\*, and PHP\* to set up a fully functional web server and host a website. Note that this tutorial installs MariaDB, which is a drop-in replacement for MySQL. +A LAMP server uses Linux\*, Apache\*, MySQL\*, and PHP\* to set up a fully functional web +server and host a website. Note that this tutorial installs MariaDB\*, which is a drop-in +replacement for MySQL. This tutorial follows these steps: @@ -380,7 +383,7 @@ our |CL| host system. Use phpMyAdmin to Manage Databases ==================================== -You can use the phpMyAdmin web-based tool to manage your databases. Follow the steps below for setting up a database called Wordpress. +You can use the phpMyAdmin web-based tool to manage your databases. Follow the steps below for setting up a database called "WordPress". #. Verify that a successful installation of all LAMP server components by going to http://localhost/phpMyAdmin. See figure 3. @@ -470,7 +473,7 @@ If successful, you should see the screen shown in figure 8: **Congratulations!** You have now created a fully functional LAMP server along with a -WordPress-ready database using |CL|. +WordPress\*-ready database using |CL|. As a next step, you could :ref:`create a WordPress server ` and present it to the world. diff --git a/source/clear-linux/tutorials/wordpress/wordpress.rst b/source/clear-linux/tutorials/wordpress/wordpress.rst new file mode 100644 index 00000000..27768e32 --- /dev/null +++ b/source/clear-linux/tutorials/wordpress/wordpress.rst @@ -0,0 +1,32 @@ +.. _wordpress: + +WordPress\* use case tutorial +############################# + +Welcome to our WordPress\* use case tutorial. This tutorial describes the steps to +setup a webserver to host a WordPress site using |CL-ATTR|. + +In this tutorial we assume your system is already running |CL|. For instructions +on how to install |CL| on bare metal, see the :ref:`bare metal install` +page from our :ref:`get-started` guide. For your convenience, we have split this +tutorial into two sections: + +#. Setting up a LAMP webserver with :ref:`web-server-install`. + +#. Setting up Wordpress on a LAMP webserver with :ref:`wp-install`. + +If you already have a |CL| based :abbr:`LAMP (Linux, Apache, MySQL, PHP)` web server, +you can skip ahead to the second section of this tutorial. + +.. note:: + + This tutorial is for development and testing purposes only. Additional steps + are required to secure production systems. Those steps are beyond the scope + of this tutorial. + +.. toctree:: + :maxdepth: 1 + :hidden: + + web-server-install.rst + wp-install.rst diff --git a/source/clear-linux/tutorials/wp-install/wp-install.rst b/source/clear-linux/tutorials/wordpress/wp-install.rst similarity index 72% rename from source/clear-linux/tutorials/wp-install/wp-install.rst rename to source/clear-linux/tutorials/wordpress/wp-install.rst index b5eda738..831acfd0 100644 --- a/source/clear-linux/tutorials/wp-install/wp-install.rst +++ b/source/clear-linux/tutorials/wordpress/wp-install.rst @@ -1,14 +1,19 @@ .. _wp-install: -Create a Clear Linux WordPress server +Create a |CL-ATTR| WordPress\* server ####################################### -This tutorial shows you how to install the WordPress components on your |CL| LAMP server. At the end of :ref:`web-server-install`, you created a WordPress\*-ready database using phpMyAdmin\* and MariaDB\*. Now that the LAMP server is up and running, you can add the WordPress components needed to host a WordPress website on your system. +This tutorial shows you how to install the WordPress\* components on your |CL| +:abbr:`LAMP (Linux, Apache, MySQL, PHP)` server. At the end of +:ref:`web-server-install`, you created a WordPress-ready database using +phpMyAdmin\* and MariaDB\*. Now that the LAMP server is up and running, you +can add the WordPress components needed to host a WordPress website on your system. Before you begin ================= -This tutorial assumes you have successfully installed :ref:`Clear Linux on bare metal` and that you have :ref:`set up a LAMP web server `. +This tutorial assumes you have successfully installed :ref:`Clear Linux on bare metal` +and that you have :ref:`set up a LAMP web server `. Before you install new packages, update the |CL| OS with the following command: @@ -21,11 +26,20 @@ Before you install new packages, update the |CL| OS with the following command: Create a WordPress server =========================== -WordPress can be installed in a variety of ways. These instructions are written for users who have followed our instructions for installing phpMyAdmin when they :ref:`set up a LAMP web server `. Note that all steps in this tutorial have been tested using a NUC6i5SYH Intel® NUC. Visit the `NUC6i5SYH product page`_ for detailed information. +WordPress can be installed in a variety of ways. These instructions are +written for users who have followed our instructions for installing phpMyAdmin +when they :ref:`set up a LAMP web server `. Note that +all steps in this tutorial have been tested using a NUC6i5SYH Intel® NUC. +Visit the `NUC6i5SYH product page`_ for detailed information. -Numerous online articles are available to help you name your website and acquire the necessary certificates. Those tasks are beyond the scope of this tutorial. +Numerous online articles are available to help you name your website and +acquire the necessary certificates. Those tasks are beyond the scope of this tutorial. -You can take several actions to harden your website from attacks. The security of your website and the data it contains are complex and ever-evolving tasks. Prioritize security if you plan to expose your website to the outside world. This tutorial does not address security measures that you can take to harden your site but we strongly encourage you to take action. +You can take several actions to harden your website from attacks. The security +of your website and the data it contains are complex and ever-evolving tasks. +Prioritize security if you plan to expose your website to the outside world. +This tutorial does not address security measures that you can take to harden +your site but we strongly encourage you to take action. .. note:: @@ -35,9 +49,11 @@ You can take several actions to harden your website from attacks. The security o Download WordPress and manage directories ------------------------------------------ -For this tutorial, you will create a WordPress blog that can be accessed at: http:///blog. +For this tutorial, you will create a WordPress blog that can be accessed at: +http:///blog. -To accomplish this setup, you must add WordPress components to the :file:`/var/www/html/blog` directory. +To accomplish this setup, you must add WordPress components to the :file:`/var/www/html/blog` +directory. Follow these steps: @@ -75,9 +91,12 @@ Follow these steps: Set up WordPress with Web-based GUI ----------------------------------- -Recall that you created a database and user when you installed phpMyAdmin during :ref:`Creating a Clear Linux based web server `. Next, you must connect WordPress to the database and install WordPress. +Recall that you created a database and user when you installed phpMyAdmin during +:ref:`Creating a Clear Linux based web server `. Next, you must +connect WordPress to the database and install WordPress. -To continue with the setup, go to: http:///blog/wp-admin/install.php. The WordPress language option screen appears, as shown in figure 1. +To continue with the setup, go to: http:///blog/wp-admin/install.php. +The WordPress language option screen appears, as shown in figure 1. #. Select :guilabel:`English` and click :guilabel:`Continue`. @@ -88,7 +107,8 @@ To continue with the setup, go to: http:///blog/wp-admin/install.p `Figure 1: WordPress language selection screen.` - The WordPress installation continues until the Welcome screen appears, as shown in figure 2: + The WordPress installation continues until the Welcome screen appears, as shown in + figure 2: .. figure:: figures/wp-install-2.png :alt: WordPress welcome screen @@ -97,7 +117,9 @@ To continue with the setup, go to: http:///blog/wp-admin/install.p `Figure 2: WordPress Welcome screen.` #. Click :guilabel:`Let’s go!`. -#. Enter database connection specifics in the screen that appears as shown in Figure 3 below. + +#. Enter database connection specifics in the screen that appears as shown in figure 3 +below. * Database name: WordPress @@ -119,7 +141,8 @@ To continue with the setup, go to: http:///blog/wp-admin/install.p #. Click :guilabel:`Submit` to complete the setup. - Figure 4 shows the confirmation screen that verifies a successful setup. WordPress is connected to the MariaDB database. + Figure 4 shows the confirmation screen that verifies a successful setup. WordPress + is connected to the MariaDB database. .. figure:: figures/wp-install-4.png :alt: Successful database connection. @@ -133,7 +156,8 @@ To continue with the setup, go to: http:///blog/wp-admin/install.p Complete successful login --------------------------- -Once the installation is complete, you can name your blog and create a Wordpress username and password. See figure 5. +Once the installation is complete, you can name your blog and create a Wordpress username +and password. See figure 5. .. figure:: figures/wp-install-5.png :alt: WordPress user creation @@ -179,7 +203,7 @@ http:///blog on your browser. Figure 8 shows the result: You have successfully installed WordPress on a host system. -Add new entries to your blog and share them with the world using |CLOSIA|! +Add new entries to your blog and share them with the world using |CL|! .. _`step-by-step guide`: https://codex.wordpress.org/Installing_WordPress#Famous_5-Minute_Install