This page for internal use only.
Welcome to the "Wikification" of the TAMU Supercomputing Facility web site. This wiki started as a simple transfer of information from a quick wiki on github.tamu.edu about our new "Ada" (ada.tamu.edu) cluster. But on upon further review, and with a mandate to incorporate it into the rest of the site (with eos.tamu.edu as an example/exemplar(*cough*)), it became more than just Ada documentation.
It is hoped this wiki will help to not only provide up to date information to SC users but to also help us, as providers of documentation, to better organize and present the information available on our web site (there really is a lot... some parts less obvious than others).
- 1 Style/Coding Guide
- 2 Images
- 3 Appearance
- 4 Testing
- 5 Converting pre-existing materials
- 6 Pages NOT to add to wiki
- 7 Cool Special:SpecialPages
- 8 Tracking
- 9 Moving/Deleting pages
- The only rule so far is not to include a section heading (typically at the top) that includes only one equal sign on each end. That is, instead of writing:
you should always start with at least two '='s. e.g.
To use an image on a page:
- Use the Upload file link on the left.
- Browse for the file to upload and then give it a name (for the wiki) and a description (if desired). Click Upload file button.
- Verify the upload by checking the File list link on the left.
- To display the image on a wiki page, use the Image keyword. e.g.
The banner at the top of most pages is due to this in LocalSettings.php:
$wgSiteNotice = "[[image:Tamusc_header.jpg]]";
The rest of the page is mainly controlled by the skin, also set in that file.
$wgDefaultSkin = "cologneblue";
You can use the Preferences link on the left to experiment with others. However, all non-SC personnel will use the default above.
We will probably want to work on developing our own "skin" based on the present web site. This involves CSS and a few other things. Jack isn't spending time on that just yet (others in this shop know CSS far better than I).
Update: 23sep2014/j-perdue - now using a modified version of the "vector" skin which lives in "$IP/skins_local" (see LocalSettings.php). Modifications include:
- disabling the side bar navigation links for guest users
- disabling the top bar navigation links for guest users
- removing the page title as the first heading on each page
- disabling the "Creative Commons" license blurbs at the bottom
See $IP/skins_local/Vector.php for details.
You can click on this page to test formatting and other things.
Converting pre-existing materials
To convert the Git Hub wiki "markdown" and the sc.tamu.edu web pages, I used pandoc.
For the Adadocs wiki (formerly hosted here), it was mostly a matter of:
#!/bin/sh #git clone https://github.tamu.edu/j-perdue/adadocs.wiki.git cd adadocs.wiki for x in `ls *.md` ; do echo "### Converting $x" ; xx=`echo $x | sed 's/.md/.mw/' | sed 's/-/_/g' | sed 's/^/Ada:/'` ; pandoc -f markdown_github -t mediawiki -o $xx $x ; done # EOF
Note that pandoc did a horrible job with tables... most of them had to be fixed manually.
For the sc.tamu.edu stuff, it is just a matter of finding the stuff between:
<!-- begin main content -->
<!-- end main content -->
and then cut/pasting to a file and running:
pandoc -f html -t mediawiki /tmp/foo
and then just cut pasting the output from that to the edit screen of this wiki. Actually, I wrote a script:
#!/bin/sh curl -L -O $1 pandoc -f html -t mediawiki `basename $1` # EOF
Then it is just a matter of giving it a URL (without a trailing slash(/)) and cutting/pasting the stuff between the header stuff at the top:
... ** [[policies/storage.php:NOSSL|Data Storage]] ** [[policies/software.php:NOSSL|Software Acquisition & Licensing]] ** [[policies/earitar.php:NOSSL|Restricted Software]]
and the privacy notice at the bottom:
[[privacy.php|Privacy Statement]] | [http://cis.tamu.edu/ Computing & Information Services] | [http://www.tamu.edu/ Texas A&M University] | [[email/?u=webmaster&d=sc.tamu.edu|Webmaster]]
Again, pandoc did a horrible job with tables and most had to be converted manually (which isn't actually too hard and looks much cleaner than the original tables (see other pages in this wiki for examples)).
Pages NOT to add to wiki
Some pages will/should remain in their current form on the existing web site.
Due to dynamic PHP/MySQL
- http://sc.tamu.edu/ - home page
- http://sc.tamu.edu/software/ - software listing
- http://sc.tamu.edu/uas/batch_status.php - queue status
Due to NetID login
- http://sc.tamu.edu/ams* - account management
- http://sc.tamu.edu/forms* - applications
- https://sc.tamu.edu/Portal/ - steering committee portal
Due to externally provided documentation
- manuals for all the misc. software
Due to other reasons
- Dr. M. Thomadakis's two technical reports on Eos... too much/many formatting and illustrations (not worth the effort)
- In addition to Dr. T.'s valiant documention, there is no point in reformatting documents linked from TAMUSC:Research_Users
Due to obvious reasons
- all .pdf, .doc, .ppt, etc. won't be bothered with
For now, each page that was converted from the (old) website should have a "From: URL" comment in the "Talk" (Discussion) page for each page. (so I can remove the "original" links scattered about)
The default skin (our modified version of the "Vector" skin) doesn't provide an easy (if any) way to move or delete a page. This will be needed as we refine the organization of this wiki.
In order to be easily able to move/delete pages:
- log in (only SC staff can do this)
- go to Preferences
- go to the Appearance tab
- change the skin to something that supports moving and deleting pages (Jack likes 'Cologne Blue')
- move pages as desired
You might want to just leave your skin set that way to make it easy to to updates. But you should be sure to check pages with the default Vector skin after you are done to verify that it looks appropriate for the user.