For institutions hosted by Atlas Systems, web pages will now be maintained in GitHub repositories (repos).
Maintaining web pages in GitHub features many upgraded benefits. Some of these include:
- Easy to contribute to your pages
- Tracking changes across versions
- Changes reflected in your live system within 1 minute
- Ease of troubleshooting by locating the date and time when problems occurred
- More flexibility for your local web development processes
Guide Navigation
Obtaining Access | Web Page Layout | Downloading a Backup of Your Web Pages | Making Changes | Reverting Changes | Using Testweb | Version Control Systems
Obtaining Access
Your repository has restricted access. Please contact support@atlas-sys.com to obtain permissions to the repository for your institution's web pages. You will need an account set up in GitHub for access. Atlas Hosting Services will send you a link to your repo when you are registered. This will allow you to edit and save (commit) changes to your web pages directly within the GitHub interface. Access is granted per individual, not per institution since individual accounts are required for tracking changes in GitHub. Please let hosting know if additional people at your institution require access to edit the web pages.
Web Page Layout
The web pages structure may appear slightly different than the directory structure in IIS that you are used to. The file structure is flattened to a single level in the repo. For example, instead of clicking the illiad folder then the Lending folder to access the lending web pages, the top level would be illiad_Lending.
The tree under the README.md file shows the folder structure as it would appear in the server.
Repository Do's and Don'ts
Your GitHub repository will give you a wide range of flexible options and tools for managing your web pages. However, there are a few restrictions and guidelines to keep in mind while editing your web pages in GitHub:
Don't: | Do: |
---|---|
|
|
Downloading a Backup of Your Web Pages
If you would like to make a backup copy of your web pages for safekeeping, these should be downloaded to your local machine rather than made within your GitHub repository. To download a copy of your web pages from GitHub to your machine, follow the steps below:
- Navigate to the homepage of your repository in GitHub.
- Click on the green "Code" button.
-
Click the "Download ZIP" option from the dropdown menu.
- A copy of the files in your web directory will be downloaded to your workstation as a ZIP file. You can then store these files wherever you'd like on your machine for safekeeping.
Making Changes
You can edit pages directly within GitHub and these changes, when committed, are reflected within a minute on your server. Only changes committed to the main branch will be applied to the web pages at this time. However, you can work on other branches and commit changes prior to merging the work onto the main branch.
Example
In the example below, we're going to change the search bar on the navigation menu to the alternative style in the include_menu.html page.
-
Navigate to the appropriate web page.
- Click the edit icon highlighted in the picture above.
- Make the appropriate changes.
- Scroll to the bottom of the pages and edit the comment box to describe the change(s) you made.
- You can optionally add an extended description.
-
Click Commit changes, making sure Commit directly to the main branch is selected.
View Change History
To see all the changes for a specific webpage:
Any changes will be marked in green and any legacy formatting/verbiage will be in red. By default, the change view is Unified with both the previous formatting and the changes included in one view. See the image below.
To view the changes in a comparison format, click the Split button. See image below.
Reverting Changes
If you make a change to a web page, but then later decide you'd like to reverse the change that you made, you can use GitHub Desktop to quickly revert the web page back to its previous version.
Step One: Download and Configure GitHub Desktop
- Download the GitHub Desktop application for your workstation.
- Navigate to the homepage of your repository.
- Click the green "Code" button.
-
Click the "Open with GitHub Desktop" option from the dropdown menu.
- A pop-up window may open in your browser asking you to confirm that you want to open the GitHub Desktop application. Confirm your decision and the application will open.
- If this is your first time opening the repository in the application, it will prompt you to sign in to GitHub and clone the repository to your machine. Follow the prompts to complete this process.
-
Your repository should now be accessible on your machine through the GitHub Desktop application. Click "Fetch Origin" at the top of the application window to ensure you have the latest version of your repository on your computer.
Step Two: Find and Revert the Change in GitHub Desktop
- After opening your repository in GitHub Desktop, click "Fetch Origin" at the top of the screen to ensure that you have the latest version of the repository loaded into the application if you have not done so already.
-
Click the "History" tab on the left side of the application window.
- Find the change that you want to revert in the History menu.
-
Right-click on the change and select "Revert Changes in Commit" from the menu.
-
A new entry should appear at the top of the History tab noting that you reverted the change.
-
Click "Push Origin" at the top of the application window to push the reverted change to your GitHub server.
- Confirm that the change has been reverted by viewing the web page on your server.
Using Testweb
If you'd like to edit the pages in your Testweb first to see how they will work in the live system, simply edit those pages and they will be updated within 1 minute so that you can verify any changes before making them in the production pages.
For example, to edit the pages in your ILLiadAuth/Testweb folder, you would find those pages to edit in the repo under:
illiadauth_testweb
Loading a New Set of Default Web Pages into Testweb
If you would like to load a new set of default web pages into your Testweb for previewing, testing, or customization, follow the steps below:
- Download the newest copy of default pages from the ILLiad Downloads page.
- The pages will download as a zip file. Extract the files in the zip file to a folder on your workstation.
-
Navigate to your repository at GitHub.com, click the green "Code" button, and select the "Open with GitHub Desktop" option.
See the Reverting Changes section of this guide for information on configuring GitHub Desktop. - A pop-up window may open in your browser asking you to confirm that you want to open the GitHub Desktop application. Confirm your decision and the application will open.
-
From the main window of the GitHub Desktop application, click "Show in Explorer."
- The File Explorer will open and display the folders in your repository. Navigate to your Testweb folder.
-
Within the Testweb folder, delete all files except webpath.txt, web.config (if present), logon.txt (if present), and any files ending in .dll (if present).
Do not delete these files or your new pages will not work properly! - Navigate to the folder containing the new default web pages you downloaded in step one. Copy the files within this folder into your Testweb folder.
- Return to the GitHub Desktop application. You should see a log of the changes made to the web pages in your directory.
- Enter a description of your changes (e.g., "Deleted old files and uploaded new 9.1 default web pages").
-
Click "Commit to main."
-
At the top of the application window, click "Push to origin."
-
Within a minute, your changes should be applied to your production server. View your Testweb and Production directories to verify that the changes were made appropriately and to check functionality.
You may also need to do a hard refresh with Ctrl-R if you find that your changes have not been applied.
Version Control Systems
Since the web pages are now hosted in GitHub, if you are familiar with Git, feel free to use your favorite interface to edit your web pages. There are several free Git tools such as the aforementioned GitHub Desktop application or free editors that support Git like Visual Studio Code.