{"id":687,"date":"2020-09-02T18:58:08","date_gmt":"2020-09-02T18:58:08","guid":{"rendered":"http:\/\/digitalscholarship.brown.edu\/support\/?p=687"},"modified":"2020-09-02T18:58:08","modified_gmt":"2020-09-02T18:58:08","slug":"how-to-use-this-documentation","status":"publish","type":"post","link":"https:\/\/digitalscholarship.brown.edu\/support\/uncategorized\/how-to-use-this-documentation\/","title":{"rendered":"How to Use this Documentation"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Digital Scholarship at Brown is a service that makes it possible for Brown students, faculty and other researchers to work with a variety of web applications and develop a web presence. It is enables you to publish research, experiment with digital tools and methods in a class or on your own. Digital Scholarship at Brown is intended to supplement the web services that Brown already offers. If one of the other web services can accomplish what you need, you should use it. You can see what else is available on the University Relations <a href=\"https:\/\/www.brown.edu\/university-communications\/digital\/websites\">Websites at Brown<\/a> page.\u00a0<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Once you have read the <a href=\"https:\/\/digitalscholarship.brown.edu\/homepage\/guidelines\/\">Guidelines for Use<\/a> and been approved for a Digital Scholarship at Brown domain, you will have to become familiar with the Control Panel (cPanel) and understand how to install and organize your web applications. This documentation covers how to use the cPanel and how to set up your applications. It also has sections on some of the more common applications (WordPress, Scalar, Omeka and and Grav, a simple, general purpose content management system).\u00a0<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Beyond cPanel<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The cPanel provides some file manipulation and GitHub access, but we anticipate that some users will prefer direct FTP and command line access and may want to install some applications of their own, although there are limits to what you can install on Digital Scholarship at Brown. Details are covered below.\u00a0<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Web Publication principles<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">As you start to work on your Digital Scholarship at Brown web application, there are three important considerations that you should take into account  in your planning and execution:<\/p>\n\n\n\n<ol class=\"wp-block-list\"><li><strong>Accessibility\/Usability: <\/strong>Produce web pages that are accessible to readers with different devices and abilities. Making your pages accessible will help them reach a wider audience, and make them ADA compliant.<ul><li>A <a rel=\"noreferrer noopener\" href=\"https:\/\/wd5.myworkday.com\/brown\/d\/inst\/17816$6698\/rel-task\/2998$29489.htmld\" target=\"_blank\">brief, clear video <\/a>on accessibility is available in Workday learning. You need to log in with your Brown ID to view this. <\/li><li>Brown IT has a document that provides <a rel=\"noreferrer noopener\" href=\"https:\/\/ithelp.brown.edu\/kb\/articles\/usability-guidelines\" target=\"_blank\">Accessibility Guidelines<\/a>. It also provides information on Brown specific formats that may not apply to your site. <\/li><li>You can learn more about web accessibility on the W3C <a rel=\"noreferrer noopener\" href=\"https:\/\/www.w3.org\/WAI\/standards-guidelines\/\" target=\"_blank\">Web Standards Accessibility Overview <\/a>page.<\/li><\/ul><\/li><li><strong>Copyright and Licensing:<\/strong> Secure the rights to use any content on your web pages that isn\u2019t created by you, or make sure that it is licensed for re-use or in the public domain. Always provide credit lines and citations, so your readers can identify the provenance of your material. Add a license and citation information of your own so others know how to cite and re-use your work.<ul><li>You can learn more about licensing your material on <a rel=\"noreferrer noopener\" href=\"https:\/\/creativecommons.org\/licenses\/\" target=\"_blank\">Creative Commons<\/a>. You can also walk through a simple questionnaire for <a rel=\"noreferrer noopener\" href=\"https:\/\/creativecommons.org\/share-your-work\/\" target=\"_blank\">choosing a license<\/a>.<\/li><\/ul><\/li><li><strong>Sustainability and Re-use:<\/strong> Think about the longevity of your site, and of the components that are in your site. How easy is it to export your material and what format will it be delivered in?  If you are aggregating data, you may want to make sure that you are also generating metadata that describes it, explains the collecting principles, context and format. If someone else wants to re-use your data, can they retrieve it easily and will it be accompanied by its metadata? <\/li><\/ol>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Technical support <\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Domains on Brown\u2019s Digital Scholarship hosting service are meant to be self-service, therefore the library offers limited technical support. Please schedule a consultation with CDS if you are unsure about your needs. We are happy to meet with you to discuss your project.\u00a0<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If you are having problems with account setup, or questions about using the cPanel or domain setup, we will do our best to help you.\u00a0<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong><em>Consultation Scheduling<\/em><\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">CDS staff can meet with you to discuss your goals for a project on the Digital Scholarship at Brown hosting service and are happy to help you strategize and get started with your project. If you are having trouble answering the questions: Which application is best for me? Should I use WordPress, Scalar, Omeka Classic, or Omeka S, or something else? How should I prepare my data? If this is being used in a class, how do I scaffold my assignments? \u2014schedule a consultation by emailing <a href=\"mailto:cds_info@brown.edu\">cds_info@brown.edu<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Digital Scholarship at Brown is a service that makes it possible for Brown students, faculty and other researchers to work with a variety of web applications and develop a web presence. It is enables you to publish research, experiment with digital tools and methods in a class or on your own. Digital Scholarship at Brown [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-687","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/digitalscholarship.brown.edu\/support\/wp-json\/wp\/v2\/posts\/687","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/digitalscholarship.brown.edu\/support\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/digitalscholarship.brown.edu\/support\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/digitalscholarship.brown.edu\/support\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/digitalscholarship.brown.edu\/support\/wp-json\/wp\/v2\/comments?post=687"}],"version-history":[{"count":1,"href":"https:\/\/digitalscholarship.brown.edu\/support\/wp-json\/wp\/v2\/posts\/687\/revisions"}],"predecessor-version":[{"id":688,"href":"https:\/\/digitalscholarship.brown.edu\/support\/wp-json\/wp\/v2\/posts\/687\/revisions\/688"}],"wp:attachment":[{"href":"https:\/\/digitalscholarship.brown.edu\/support\/wp-json\/wp\/v2\/media?parent=687"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/digitalscholarship.brown.edu\/support\/wp-json\/wp\/v2\/categories?post=687"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/digitalscholarship.brown.edu\/support\/wp-json\/wp\/v2\/tags?post=687"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}