Editing Atlas Hosted Web Pages in GitHub

Print Friendly and PDF Follow

For institutions hosted by Atlas Systems, web pages will now be maintained in GitHub repositories (repos). For more information about the new hosting environment, you can review https://www.atlas-sys.com/server-hosting-migration.

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

GitHub_Repo.png

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 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 Illiadauth folder then the Lending folder to access the lending web pages, the top level would be Lending.

Screen_Shot_2020-05-13_at_4.30.18_PM.png

The tree under the README.md file shows the folder structure as it would appear in the server. 

ReadMe.png

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 master 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 master 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.

  1. Navigate to the appropriate web page.

    EditPage.png
  2. Click the edit icon.
  3. Make the appropriate changes.
  4. Scroll to the bottom of the pages and edit the comment box to describe the change(s) you made.
  5. You can optionally add an extended description.
  6. Click Commit changes, making sure Commit directly to the master branch is selected.

    CommitChanges.png

View Change History 

To see all the changes for a specific webpage:

  1. Navigate to the appropriate web page.
  2. Click the History button.

    Screen_Shot_2020-05-13_at_12.23.23_PM.png
  3. Click the title of the change.
  4. View Changes.

    Screen_Shot_2020-05-13_at_12.24.02_PM.png

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.

DefaultView_History.png

To view the changes in a comparison format, click the Split button. See image below.

SplitView_History_.png

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

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 GitHub Desktop or free editors that support Git like Visual Studio Code

 

Questions?

If this article didn’t resolve your issue, please take a moment and answer a few questions to help improve our documentation:

Feedback