- Home
- Style Guide
- Style Guide: Shortcodes and Content Entry Options
Shortcodes
There are different shortcodes available for use. Currently, they are used to set basepaths for environment-specific URLs and for Font Awesome icons that we want to include. The general syntax for shortcodes is [[type: name]].
Site Basepath URLs
Site URLs set the basepath for our internal applications. Internally, we have several different environments so using shortcodes allows the links to these applications to be environment specific. Note: Use double brackets, not single.
[url: store] = https://estoreuat.cap.org
- Site: Online store
- Example: "http://estore.cap.org/xyz" should be replaced with [url: store]/xyz"
- test link
[url: learn] = https://cap.hosted.test.cloud.ethosce.com/
- Site: Learning site
- Example: "https://cap.hosted.test.cloud.ethosce.com/xyz" should be replaced with "[url: learn]/xyz"
- test link
[url: elss] = https://elssuat.cap.org/elss
- Site: e-LAB Solutions Suite
- Example: "http://www.cap.org/elss/xyz" should be replaced with "[url: elss]/xyz"
- test link
[url: app-suite] = https://appsuiteuat.cap.org
- Site: Used for "AppSuite" Oracle HTTP Server ("OHS")
- Example: "http://www.cap.org/appsuite/xy..." should be replaced with "[url: app-suite]/xyz
- test link
[url: web-apps] = https://webappsuat.cap.org
- Site: Used for legacy Applications (ie "apps/docs" and "cap.portal")
- Example 1: "http://www.cap.org/apps/docs/x..." should be replaced with "[url: web-apps]/apps/docs/xyz"
- Example 2: "http://www.cap.org/apps?cap.po..." should be replaced with "[url: web-apps]/apps?cap.portal/xyz"
- test link
[url: apps] = https://apps.cap.org
- Site: Used for "apps" subdomain
- test link
Font Awesome Icons
Select, pre-loaded icons from the Font Awesome icon library are listed below.
Format: [icon: icon-name] (note: use double-brackets)
- arrow-right
- bar-chart
- book-open-cover-solid
- check-circle
- chevron-up
- chevron-down
- chevron-left
- chevron-right
- chrome
- close
- desktop
- edge 44 and down
- edge 80 and up
- exclamation-circle
- file-search
- file-text-o
- firefox
- head-side-brain-solid
- head-side-headphones-solid
- internet-explorer
- laptop-file-solid
- location-dot-solid
- lock
- newspaper
- podcast-solid
- safari
- search
- shopping-cart
- times-circle
- user
- video-solid
- youtube
- youtube-play
Links
Email links
mailto:emailname@cap.org?subject=subject line goes here
Tags
#inApplicationCode = Indicates that the page URL is embedded in an Internal Application. Impact: Changing the URL may require a code build/release.
Filename Formats
- All lower case
- Short, descriptive title (reflects content)
- Use hyphens/dashes to separate words
- Do not use any spaces
- Do not use special characters
- Include year when relevant/related to content of asset
- yyyy-name-v1234
- cancer-protocol-ampulla-vater-v4010 or cp-ampulla-vater-v4010 (this is how Ryan brought them in)
Lock Icons
We manually add lock icons when linking to protected content. Ideally, the icon should be placed to the left of the link itself. There are exceptions to this based on content layout. Use judgment as needed.
Example: link