Editing A2HostingEnvironment

__FORCETOC__ 
<!-- __NOTOC__ will force TOC off -->
=a2Hosting MediaWiki Environment=

==Tests and Lessons in 2021==
===June 4===

[[File:RmodeHBookImage3.png|right|r-mode image (300 x 225 px)]]

I successfully uploaded the "r-mode image" &#8212; shown here, on the right &#8212; from my Mac to the a2Hosting file system.
<ol>
  <li>I pointed my browser to the URL: Tohline.education/SelfGravitatingFluids; this opened the "Main Page" of my MediaWiki app</li>
  <li>I logged into the MediaWiki site; as a result, the "Upload file" link was added to the left-hand menu</li>
  <li>Clicking on this "Upload file" link, a familiar MediaWiki page opened; it allowed me to upload a selected r-mode image from my Mac</li>
  <li>From the a2Hosting's cPanel, I double-clicked on the "File Manager"; I located the file under public_html/SelfGravitatingFluids/images/3/3b</li>
</ol>

===June 5===
I found [https://www.siteground.com/kb/how_to_change_my_mediawiki_logo_image/ this URL] useful as I attempted to change my MediaWiki Logo image.

Via a cPanel-Terminal session, I changed directory to "~/public_html/SelfGravitatingFluids" and &hellip;
<ol>
  <li>Found <font color="green">index.php</font>; its contents were not immediately useful.</li>
  <li>Found <font color="green">LocalSettings.php</font>
  <ol type="a">
    <li>$wgServer = "https://tohline.education"</li>
    <li>$wgScriptPath = "/SelfGravitatingFluids"</li>
    <li>$wgResourceBasePath = $wgScriptPath</li>
    <li>$wgLogos = [ '1x' => "$wgResourceBasePath/resources/assets/wiki.png" ];</li>
  </ol>
  </li>
</ol>

I realized that, when using the cPanel-File_Manager, I must click on the **name** (e.g., SelfGravitatingFluids) of a directory folder as well as the tiny folder icon in order to see all of the directory's files and sub-directories.

[[File:RmodeImage5big.png|right|200px|r-mode image (300 x 300 px)]]

I successfully uploaded the "r-mode image" &#8212; shown here, on the right &#8212; from my Mac to the a2Hosting file system.  

<ol>
  <li>It is 135 x 135 pixels, which is the size used for the replacement MediaWiki Logo; actually, what is displayed here is a 300 x 300 pixel image.</li>
  <li>From the a2Hosting's cPanel, I double-clicked on the "File Manager"; I located the file under public_html/SelfGravitatingFluids/images/8/8b; actually, the displayed image is in ~/images/9/97</li>
  <li>Now, let's try opening the <font color="green">LocalSettings.php</font> file and changing the $wgLogos specification to read:<br />$wgLogos = [ '1x' => "$wgResourceBasePath/images/8/8a/RmodeHBookImage6.png" ];</li>
  <li>That did not work, but the following did:<br />$wgLogos = [ '1x' => "images/8/8a/RmodeHBookImage6.png" ];</li>
  <li>I added the "Self-Gravitating Fluids" label to the same image, then repeated the above-enumerated upload steps.  Now the appropriate Logo can be found at the following location:<br /><font color="red">$wgLogos = [ '1x' => "images/d/d3/RmodeImage8.png" ];</font></li>
</ol>

Where do new MediaWiki pages get stored?
<ol>
  <li>Looks like one ''test'' example is at:  ~/www/SelfGravitatingFluids/tests/phpunit/includes/page/</li>
  <li>Perhaps the real thing is at:  ~/www/SelfGravitatingFluids/includes/page/</li>
  <li>Even more likely to be useful:  ~/www/SelfGravitatingFluids/includes/content/<br />
<font color="maroon">88% into ''TextContent.php'' &hellip;</font> "Generates an HTML version of the content, for display.  Used by fillParserOutput() to provide HTML for the ParserOutput object."
  </li>
</ol>

===June 8===
SSH and SFTP.
<ol>
  <li>After reading [https://www.a2hosting.com/kb/getting-started-guide/accessing-your-account/using-ssh-secure-shell this document], I learned how &#8212; from my iMac &#8212; to log into the a2Hosting linux servers via a secure shell (SSH; port 7822) session.</li>
  <li>After reading [https://www.a2hosting.com/kb/getting-started-guide/accessing-your-account/using-ftp-with-linux-hosting-accounts a separate document], I followed a2Hosting's advice and installed [https://filezilla-project.org/download.php FileZilla] on my iMac.  This allows me &#8212; via a very pleasant "windowed" interface &#8212; to establish and use SFTP to transfer files from the iMac to my account on a2Hosting servers.</li>
</ol>

Contemplate installation of "Math" extension.
<ol>
  <li>Consider reading <font color="darkgreen">www.mediawiki.org/wiki/Manual:Configuration_settings</font></li>
  <li>Steps drawn from: [https://www.mediawiki.org/wiki/Extension:Math#Installation Extension:Math#Installation]
<ul>
<li>Download and place the file(s) in a directory called Math in your extensions/ folder.</li>
<li>Add the following code at the bottom of your ~/SelfGravitatingFluids/LocalSettings.php:
  <ul>
    <li>wfLoadExtension( 'Math' );</li>
  </ul>
</li>
<li>Run the update script which will automatically create the necessary database tables that this extension needs.  According to [https://www.mediawiki.org/wiki/Manual:Update.php this documentation], updating involves the following: (1) Change to the '''maintenance''' directory, then at the command-line prompt, type '''php update.php'''.</li>
</ul>
  </li>
</ol>

===June 9===
Download and Install Extension:Math
<ol>
  <li>From Safari on my iMac, I went to the page titled, [https://www.mediawiki.org/wiki/Special:ExtensionDistributor/Math Download MediaWiki extension]; this means that the downloaded file(s) will initially end up on my iMac, under folder &hellip; ~/myMediaWiki/Math</li>
  <li>It asked for MediaWiki version number &hellip;
  <ul>
<li>Under the ''Tools'' subsection of the Main_Page sidebar, click on '''special pages''';</li>
<li>Then, under the ''Data &amp; Tools'' subheading, click on '''Version'''.</li>
<li>ANS:  the a2Hosting installation was <font color="red">Version = 1.36.0</font>, which is the version number labeled "latest stable MediaWiki" on the extension download page.
  </ul>
<table border="0" align="center" width="80%">
  <tr><td align="left">
[[File:READMEdownloadMathExtension.png|600px|README download Math Extension (9 June 2021)]]
  </td></tr>
</table>
  </li>
  <li>I directed the "snapshot URL" download link to put the ~.tar.gz file directly into the ~/myMediaWiki/Math folder on my iMac.  From the command line of my iMac's ''terminal'' screen I typed:  <font color="darkgreen">tar -xzvf Math-REL1_36-8c7c35b.tar.gz</font>.  Looks like this file was unwrapped properly; the unpacking involved (1) creation of a subfolder named "Math" and (2) storing all files in this newly created folder.  Note that, since the unpacking self-generated the new "Math" subfolder, I ended up with a ~/Math/Math/ folder construction.</li>
  <li>Using ''FileZilla'' on my iMac, I transferred (via SFTP) the original ~.tar/gz file into the extensions subfolder of my SelfGravitating wiki site on the a2Holding server.  Then, using the cPanel terminal app, I changed into the ~/SelfGravitatingFluids/extensions folder and typed the same command, namely: <font color="darkgreen">tar -xzvf Math-REL1_36-8c7c35b.tar.gz</font>.  A new "Math" subfolder was created within the "extensions" subfolder and all of the "unpacked" files appear to have been properly stored there.</li>
  <li>
Carry out the last couple of 8 June ''contemplated steps''.
<ul>
<li>Add the following code at the bottom of your ~/SelfGravitatingFluids/LocalSettings.php:
  <ul>
    <li>wfLoadExtension( 'Math' );</li>
  </ul>
</li>
<li>Run the update script which will automatically create the necessary database tables that this extension needs.  According to [https://www.mediawiki.org/wiki/Manual:Update.php this documentation], updating involves the following: (1) Change to the '''maintenance''' directory, then at the command-line prompt, type '''php update.php'''.</li>
</ul>
  </li>
  <li>
<font color="red">'''HOORAY!!'''</font> As is illustrated in Table 1, the LaTex instructions appear to work:  (''left'') a few lines of plain text, and (''right'') the "Extension:Math" rendering results.  NOTE:  These (admittedly simple) math expressions are ''not'' embedded .png images but, rather, have each letter placed individually; this is illustrated by the fact that the light-blue background color is able to color throughout the expressions.

<table border="1" align="center" cellpadding="8">
<tr><td colspan="2" align="center">'''Table 1'''</td></tr>
<tr><td align="center">Plain Text</td><td align="center">Rendering</td></tr>
<tr>
  <td align="left">
<pre>
I'm just testing to see if I'm properly editing.
<math>
E = mc^2
</math>

<div align="center">
<math>H = \int\frac{dP}{\rho}</math> .
</div>
</pre>
  </td>
  <td align="left" bgcolor="lightblue">
I'm just testing to see if I'm properly editing.
<math>
E = mc^2
</math>

<div align="center">
<math>H = \int\frac{dP}{\rho}</math> .
</div>
  </td>
</tr>
</table>
  </li>
</ol>


{{SGFfooter}}