{"id":8194,"date":"2021-11-22T20:50:41","date_gmt":"2021-11-22T20:50:41","guid":{"rendered":"http:\/\/sites.la.utexas.edu\/kb\/?p=8194"},"modified":"2021-11-22T20:53:13","modified_gmt":"2021-11-22T20:53:13","slug":"pages-sta-essentials","status":"publish","type":"post","link":"http:\/\/sites.la.utexas.edu\/kb\/2021\/11\/22\/pages-sta-essentials\/","title":{"rendered":"Pages STA Essentials"},"content":{"rendered":"\n<h1 class=\"wp-block-heading\">Overview<\/h1>\n\n\n\n<p>Pages is the content management system (CMS) that will be used for the College of Liberal Arts site.&nbsp;<\/p>\n\n\n\n<p>It comes from GrapesJS, an open-source web development tool that allows developers to add custom CSS elements into blocks in a what you see is what you get (WYSIWYG) interface. This makes things much easier for the client to edit the website on their own.<\/p>\n\n\n\n<p>For a general overview of these different blocks, how to use, and best practices when uploading assets, please review the User Manual <a href=\"https:\/\/utexas.box.com\/v\/pages-manual\">here<\/a>.<\/p>\n\n\n\n<p>That said, while Pages is made to be easy to use and accessible for all clients regardless of web development experience or ability, there are a few things to keep in mind, especially where images are concerned.&nbsp;<\/p>\n\n\n\n<p>Once you upload an image to a page, regardless of the component it\u2019s situated in (hero image, callout post, button, etc.) how it appears will not change or adjust in any way on the live site. To put it more clearly, size will not auto adjust to fit the page or other elements, and there is no way to change this in code either.&nbsp;<\/p>\n\n\n\n<p>You must make sure to do any edits before you upload to Pages.&nbsp;<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Types of Images<\/strong><\/h2>\n\n\n\n<p>First, it might be helpful to distinguish between two kinds of images: raster and vector images.&nbsp;<\/p>\n\n\n\n<p><strong><span class=\"has-inline-color has-black-color\">Raster images<\/span><\/strong> are probably the images you see the most and what you\u2019re probably thinking of when I say \u201cimages\u201d. They\u2019re composed of pixels, funky little guys that are also a common unit of measurement for pictures. This is all well and good, but unfortunately raster images don\u2019t look great when expanded, since the pixels must stretch to compensate for this increased space. This often results in a low-resolution image.\u00a0<\/p>\n\n\n\n<p><strong>Common file formats: JPEG, PNG, and GIF<\/strong><\/p>\n\n\n\n<p><strong>Vector images<\/strong> are the second kind of commonly used image type and perhaps more commonly known as vector graphics. Instead of using a bitmap of pixels, they are composed of a variable number of lines and curves that contain various shapes. These points, lines, and curves may be scaled up and down as needed, basically infinitely.&nbsp;<\/p>\n\n\n\n<p><strong>Common file formats: SVG, PDF, and AI<\/strong><\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Types of Images to Use for Pages<\/strong><\/h2>\n\n\n\n<p><strong>Always try to export\/save your images as a JPEG\/JPG.<\/strong> This file type is smaller and loads faster on web servers. The one exception is you have an image with a transparent background, in which case you must use a PNG as this is not supported by JPEG\/JPG.&nbsp;<\/p>\n\n\n\n<p>Pages will not render PDF files. These must be hosted in Minio.<\/p>\n\n\n\n<h1 class=\"wp-block-heading\">Image Sizes<\/h1>\n\n\n\n<h2 class=\"wp-block-heading\">Maximum image widths:<\/h2>\n\n\n\n<p><strong>Max image width for all components <\/strong><strong><em>but the hero image:<\/em><\/strong> 640px<\/p>\n\n\n\n<p><strong>Max image width for hero images:<\/strong> 1400px<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Minimum image widths:<\/h2>\n\n\n\n<p><strong>Hero images:<\/strong> 1000px<\/p>\n\n\n\n<p><strong>Text with image:<\/strong> 320px<\/p>\n\n\n\n<p><strong>Callout box:<\/strong> 360px<\/p>\n\n\n\n<p><strong>Two card images:<\/strong> 460px<\/p>\n\n\n\n<p><strong>Three card images:<\/strong> 320px<\/p>\n\n\n\n<p><strong>Image buttons:<\/strong> 320px<\/p>\n\n\n\n<p>Always save the highest quality version of the image you possess. If it originates in Photoshop, ensure that you <strong>Save for Web<\/strong>. In most cases, Pages will adjust image weight if it\u2019s a little high, so never go with a compressed image unless you must.<\/p>\n\n\n\n<h1 class=\"wp-block-heading\">Image Sourcing and Basic Editing&nbsp;<\/h1>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Photo Sourcing<\/strong><\/h2>\n\n\n\n<p>One important aspect of Pages content management is photo sourcing. It\u2019s incredibly valuable knowledge to know how to pick a photo.<\/p>\n\n\n\n<p>Here are a few sites you can depend on for copyright-free OR licensed usage photos. For a more comprehensive list and to fully understand what photo sourcing entails, please complete the <a href=\"http:\/\/sites.la.utexas.edu\/kb\/2021\/04\/14\/lesson-6-photo-sourcing-and-color-grading\/\">Photo Sourcing and Color Grading training<\/a>.<\/p>\n\n\n\n<p><a href=\"https:\/\/unsplash.com\/\"><strong>Unsplash<\/strong>:<\/a> for general photos unrelated to UT imagery<\/p>\n\n\n\n<p><a href=\"https:\/\/utexas.imagerelay.com\/\"><strong>UT Image Relay<\/strong>:<\/a> must request access, repository of UT Photography to be used for official UT communications purposes.&nbsp;<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Photo Cropping&nbsp;<\/strong><\/h2>\n\n\n\n<p>As mentioned before, there is no tool in the system that permits you to crop or auto resize photos. This must be done before upload.&nbsp;<\/p>\n\n\n\n<p>There are many free resources likely available on your machine as well on the Internet that can resize or crop photos. However, one of the cleanest methods is via Photoshop.<\/p>\n\n\n\n<p>I will demonstrate the process below. This is the raw image I started with (sourced from Unsplash), beside the edited photo, in its final habitat on the live page as an image button. To find out more about how to source images appropriately, scroll above to the \u201cPhoto Sourcing\u201d section and be sure to take the Photo Sourcing and Color Grading training [link tba].<\/p>\n\n\n\n<p><strong>Before<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-image is-resized\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/lh6.googleusercontent.com\/PrWOuByL4wlNffe7tA_Jn0-nz2ZtrV6x3Z_7xWBcUBRgT5IrL1Mgr0EiGKyjgdVaykOa2sWycirK5sUfpXg-T3rbO_yP8SGfPL5ijqDGhRTsvuYkKwZI0Kw1BJaSyiTedbA3RwnZ\" alt=\"\" width=\"365\" height=\"462\" \/><\/figure>\n\n\n\n<p><strong>After (as a component in Pages<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh5.googleusercontent.com\/uocSOWjYRu6DE8NDYeKnLdizFJii4SyT2oHAjjb5OFiCt20GrjjQJyus_BVpev6UYo2i56q4_EaufdoDsd2qYDiBKoWMt3KX6Bqq434BY-3qy1lDKGBRv-lma7otRz-qtPXcE4k8\" alt=\"\" \/><\/figure>\n\n\n\n<p>I start by opening a new blank PS file. In this case, I created a PSD with the dimensions I wanted for these buttons. It\u2019s important to keep dimensions standard across these components. Extremely large images (over 1400 px will be automatically sized down). You can always click the \u201ceye\u201d\/Preview button in Pages to see how different image sizes will look on the live site before deciding.<\/p>\n\n\n\n<p>Drag and drop your chosen image into the file, and hold shift while adjusting its position on your artboard so as not to distort the image.<\/p>\n\n\n\n<p>If you\u2019re having trouble moving the image, make sure the \u201cmove\u201d tool on your sidebar is selected.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh6.googleusercontent.com\/myYsRb8R3mQx2Gcp_BHIP_nFyxms-nLWb-KDM3Al_HxDtddjap09PUEND9nGihFU0XH4dPoIgmed9YM1Qv1bdgUdsn-efLz4Il20kzsp_xbfd42wGsMOAaZzvqqRZSKhsBr2ge_T\" alt=\"\" \/><\/figure>\n\n\n\n<p>You might also like to add a fill layer with low (50% or lower) opacity to tone down the vibrance of the image. I recommend using one of the <a href=\"https:\/\/brand.utexas.edu\/identity\/color\/\">UT Brand Colors<\/a> to accomplish this and adhere to the branding.<\/p>\n\n\n\n<p>Once you\u2019re satisfied with the positioning of the photo, navigate to File &gt; Export &gt; Save for Web to save a high quality version of this graphic to your machine. This now can be uploaded to Pages, and if you are creating a set of similar assets, repeat the process.&nbsp;<\/p>\n\n\n\n<p><strong>How to Save Images \/ Export , What Size, Specs<\/strong><\/p>\n\n\n\n<p>It is generally recommended that you export all images as JPG. If exporting from Photoshop, follow the path File &gt; Export &gt; Save For Web.<\/p>\n\n\n\n<p>Sizes are also an important thing to keep in mind.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Naming Photos&nbsp;<\/strong><\/h2>\n\n\n\n<p>One thing to remember is to not give images the same names, particularly if you wish to have two different images with the same name show up on your Pages site. The way the backend development works, the most recently uploaded image will show up always when identical names are present.&nbsp;<\/p>\n\n\n\n<p>Moreover, it\u2019s important to choose names carefully when you title them. Instead of a random string of numbers or letters, be intentional when you name files. This will allow caretakers of the site to quickly identify your titles.&nbsp;<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh3.googleusercontent.com\/hr5CxlvM-q6FtxvWVCom6gFfp5hRzhsiASvf9GG-ZpvaeiuhNNm5ReFOx2j5NCGBAmyoJSovfiZ35MzWacwtDoIbdkPs8HECNM6k6PLL-ks3YOuQwehMharmIP-SfU-1ztHqNrft\" alt=\"\" \/><\/figure>\n\n\n\n<p>Continuing with the earlier example, saving my crop of the eventual button above, I titled it MaymesterButton-UKEducation.jpg<\/p>\n\n\n\n<p>If you like, you can be more detailed and descriptive with your file name. Just make sure there\u2019s enough to tell what it is at a glance. Remember that in the distant future a content manager or STA might be handling these files, and they should be able to decipher what in the world your asset is supposed to be from the file name.&nbsp;<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Alt Text<\/strong><\/h2>\n\n\n\n<p>Pages will automatically include \u201cCollege of Liberal Arts\u201d as default alt text, basically removing the possibility of there being no or \u201cnull\u201d alt text for an image. However, some images may require custom alt text.&nbsp;<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What is alt text?<\/h2>\n\n\n\n<p>Alt text, as it\u2019s usually called, or alternative text (as it\u2019s a contraction of), is text included as an alternative to any images on a site. They are usually short descriptions of any relevant information than an image conveys.&nbsp;<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Why is alt text used?&nbsp;<\/h2>\n\n\n\n<p>Images are often some of the most widely used components on websites. If people cannot access these images, this can create major barriers. Alt text can:<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>Help orient people with disabilities who are using screen readers or dictation software to orient themselves on the page<\/li><li>Display information for an image that might be blocked due to internet connectivity or various software<\/li><li>To improve search engine optimization (SEO)&nbsp;<\/li><\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">How do I write alt text?&nbsp;<\/h2>\n\n\n\n<p>Is an image decorative (a banner, for instance, or a stock image with no real informative purpose) or includes information already found in the text content of the page? If so, no need to include alt text! Logos are also not recommended to have alt text. Although alt text is sometimes needed, too much alt text can actually impede accessibility improvement as it may clutter screen readers for users and be difficult to absorb.&nbsp;<\/p>\n\n\n\n<p>Quick reference for cases you should not use alt text:<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>Logos (branding)&nbsp;<\/li><li>Decorative images (<a href=\"https:\/\/www.w3.org\/WAI\/tutorials\/images\/decorative\/\">What are decorative images?<\/a>)<\/li><li>Complex charts or graphs (<a href=\"https:\/\/www.w3.org\/WAI\/tutorials\/images\/complex\/\">How should I handle these?<\/a>)<\/li><li>It already has a caption&nbsp;<\/li><\/ul>\n\n\n\n<p>If it includes information not otherwise found, such as an image that demonstrates or supplements something found in the text, it might be best to add some alt text.&nbsp;<\/p>\n\n\n\n<p>The key for writing good alt text is to <strong>keep things concise and clear<\/strong>. Never begin your alt text with \u201cimage of\u201d or make assumptions about what\u2019s in the image.&nbsp;<\/p>\n\n\n\n<p>For complex images like graphs or charts, you may want to write a longer description if time and resources allow, apart from the alt text input form. More information about complex images and how to write longer image descriptions in conjunction with or in addition to succinct alt text can be found <a href=\"https:\/\/www.w3.org\/WAI\/tutorials\/images\/complex\/\">here<\/a>.&nbsp;<\/p>\n\n\n\n<p>Here are a couple of practical examples:<\/p>\n\n\n\n<p>Here is a screenshot from the Czech language page. Each language page has its own banner, and here\u2019s one of them. Do we need alt text?&nbsp;<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh5.googleusercontent.com\/ANJv3cimWDHqxOFC84ELNFyVJ9sGhzIdUwT8nEg5CwSvl30omltXHW2j_gfxGbS59qovaHMvhLAHDPtNWfXs-PRFfBgESpsERXXct16JO77WhvGPSwPJ4aa68GEvLeH7I0voWNks\" alt=\"\" \/><\/figure>\n\n\n\n<p><strong>Answer:<\/strong> No, because it is a banner simply including the name of the language as well as a purely decorative\/aesthetic backdrop.&nbsp;<\/p>\n\n\n\n<p>Here\u2019s another example that I grabbed from the LA 101, under the Student Resources section.&nbsp;<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh4.googleusercontent.com\/XUKYJmBjk_zlL-U1zl_GjpFzmLUPX-WoiVkecnTE3M5WtA_kRq5QjJtyNVvn4xXuiDNpMPYcqOegZQrCKtQ7xuShAWP02Y5J6V3WLTGeBHRbup6wX_Kv8ZqWBxxtciGpOZmbm7C5\" alt=\"\" \/><\/figure>\n\n\n\n<p>Does this image need alt text? It\u2019s not a graph or a painting; however, <strong>it does add supplemental meaning to the page<\/strong>.<\/p>\n\n\n\n<p>Therefore, it should have alt text. Click on the image and, navigating to the sidebar where the gear icon is highlighted, click into the \u201calt text\u201d field.<\/p>\n\n\n\n<p><strong>First attempt:&nbsp;<\/strong><\/p>\n\n\n\n<p><em>Students in LA 101P classroom learning and collaborating with one another, a collage<\/em><\/p>\n\n\n\n<p>Although this alt text is well-intentioned, it\u2019s pretty verbose. Let\u2019s try to condense it. Also, notice how it\u2019s not one image, but 4 in a collage. Let\u2019s take note of this format to try to convey this to the user.<\/p>\n\n\n\n<p><strong>Second attempt:<\/strong><\/p>\n\n\n\n<p><em>A collage of LA 101P students working together in the classroom.<\/em><\/p>\n\n\n\n<p>This is a little better, but still makes some assumptions. Are these LA 101P students? Likely, maybe, but we have no way of knowing for certain; there\u2019s no sign or information in these images to suggest these aren\u2019t just a collage of ordinary classroom shots. Also, are they working together? Maybe, that\u2019s a pretty sweet thought, but it shows interpretation.&nbsp;<\/p>\n\n\n\n<p><strong>Best attempt:<\/strong><\/p>\n\n\n\n<p><em>Collage of students in class<\/em><\/p>\n\n\n\n<p>It\u2019s short, succinct, and doesn\u2019t suggest that these are students in any particular class with any particular collaborative aspect.<\/p>\n\n\n\n<p>By saving, we can inspect element and see that this alt text is now present in the HTML markup of the image, helping to make the College of Liberal Arts site a little more accessible for all. Yay!<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh3.googleusercontent.com\/WFrgBExVnhiYCFPt_gOA_6jZVQfbDLgbqzGB1tc9rZZds7VnCp78Vd4sVfxBmeGCSYZF1YMiHut1ggrem-a5TcVspD5FWup4Ofk1lIHdstLyKv4dJ9pbi1a9GBtC8txoTe8Gy4xU\" alt=\"\" \/><\/figure>\n\n\n\n<h1 class=\"wp-block-heading\">Other resources:<\/h1>\n\n\n\n<ul class=\"wp-block-list\"><li><a href=\"https:\/\/minio.la.utexas.edu\/minio\/login\">Minio<\/a> for hosting PDF files. Please remember to honor web paths when placing images. Log-in info is available on <a href=\"https:\/\/stache.utexas.edu\/\">UT Austin Stache<\/a><\/li><li><a href=\"https:\/\/wikis.utexas.edu\/display\/larc\/\">UT Liberal Arts Wiki<\/a> for transferring internal unit documentation<\/li><li><a href=\"https:\/\/www.w3.org\/WAI\/tutorials\/images\/decision-tree\/\">Decision tree for when and what kind of alt text to write<\/a><\/li><\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Overview Pages is the content management system (CMS) that will be used for the College of Liberal Arts site.&nbsp; It comes from GrapesJS, an open-source web development tool that allows developers to add custom CSS elements into blocks in a &hellip; <a href=\"http:\/\/sites.la.utexas.edu\/kb\/2021\/11\/22\/pages-sta-essentials\/\">Continue reading <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":753,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"ngg_post_thumbnail":0,"footnotes":""},"categories":[179162,142537],"tags":[],"class_list":["post-8194","post","type-post","status-publish","format-standard","hentry","category-cola-web-editor","category-pages"],"_links":{"self":[{"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/posts\/8194","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/users\/753"}],"replies":[{"embeddable":true,"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/comments?post=8194"}],"version-history":[{"count":3,"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/posts\/8194\/revisions"}],"predecessor-version":[{"id":8197,"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/posts\/8194\/revisions\/8197"}],"wp:attachment":[{"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/media?parent=8194"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/categories?post=8194"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/tags?post=8194"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}