Category Archives: Creating Content

Creating content for the web

Content as UX in August

Content-as-UX Content is User Experience! Join me in the Studio@Butler for the Content as UX workshop series. The sessions will be held on August 7, 15, and 21 (all Thursdays) from 10-11:30 a.m. Please RSVP via email to candicekail@columbia.edu.

Content as UX: Creating Content & Writing for the Web is a series of three workshops to help you explore online expression in various forms and to learn about creating effective online content, whether you want to give readers the information they need quickly or entice them to explore more fully. We read and negotiate information differently in an online context. This series explores how we read in online environments and how to craft our online content to best engage our users.

Just as literature encompasses various forms, from sonnets to novels to theatrical comedies, so does online writing and content. From tweets, social media posts, and mobile content to blog articles and expository content, writing for the web involves a mixture of talent, inspiration, craft, and artistry. In much the same way that an informational brochure’s content differs from the content of an article, web content changes depending on its function and where it resides. Like other types of content, the way it is crafted and developed can impact its effectiveness.

In this workshop, you will begin to think more critically about web content, learn writing techniques suited to the web as a medium in its various forms, and work on developing an approach to your own web content. Join me for three sessions and begin to reshape your online communication approach.

 

Writing for the Web Seminar Series Wrap-Up

Thanks to all who attended the Creating Content & Writing for the Web Seminar Series! I found it really valuable to hear your insights and read your feedback, and I thoroughly enjoyed our sessions. Here’s to Content as UX!

I’m working on pulling together all of the materials we used into blog posts. In the meantime, I’ve attached my slides from session two and session three, as well as my initial working bibliography.

I’m also exploring ways to share online resources effectively. I’m going to start with the Blog Roll and see how quickly that becomes overwhelming!

I’ve been thinking more about content as user experience, and how our content is the reason our users return again and again. The conversations we have with our online community are really key, and valuably contribute to our endeavors to create communities of research, teaching, learning, and inquiry (thanks CCNMTL rewired!). I’m finding new materials on digital writing, which will impact the next seminar series and which I will share (once I’ve had time to digest the ideas a little more thoroughly).

 

Creating Content & Writing for the Web

Join me in the Studio@Butler for Creating Content and Writing for the Web. The workshops will be held on April 15, 22, and 29 (all Tuesdays) from 2-3:30 p.m. Please RSVP candicekail@columbia.edu.

Creating Content and Writing for the Web is a short series of workshops for librarians and other content contributors within the libraries to explore online expression in various forms. Just as literature encompasses various forms – from haiku to the novel to theatrical comedies – so too does online writing and content. From tweets, social media posts, and mobile content to blog articles and expository content, writing for the web involves a mixture of talent, inspiration, craft, and artistry. In much the same way that an informational brochure’s content differs from the content of an article, web content changes depending on its function and where it resides. Like other types of content, the way it is crafted and the processes by which it’s developed can impact its effectiveness. In this workshop, participants will begin to think more critically about web content, learn techniques suited to the web as a medium in its various forms, and work on developing an approach to their own web content. Join me for three sessions and begin to reshape your online communication approach!

Upcoming Workshop Series: Creating Content and Writing for the Web

Join me in the Studio@Butler for Creating Content and Writing for the Web. The workshops will be held on April 15, 22, and 29 (all Tuesdays) from 2-3:30 p.m. Please RSVP candicekail@columbia.edu.

Creating Content and Writing for the Web is a short series of workshops for librarians and other content contributors within the libraries to explore online expression in various forms. Just as literature encompasses various forms – from haiku to the novel to theatrical comedies – so too does online writing and content. From tweets, social media posts, and mobile content to blog articles and expository content, writing for the web involves a mixture of talent, inspiration, craft, and artistry. In much the same way that an informational brochure's content differs from the content of an article, web content changes depending on its function and where it resides. Like other types of content, the way it is crafted and the processes by which it's developed can impact its effectiveness. In this workshop, participants will begin to think more critically about web content, learn techniques suited to the web as a medium in its various forms, and work on developing an approach to their own web content. Join me for three sessions and begin to reshape your online communication approach!

Formatting links in CQ

It’s important to format hyperlinks on your pages correctly to make maintenance as easy as possible.  If you use relative links, CQ can track the relationships between LibraryWeb pages, and automatically update your hyperlinks if a page is moved.  Remember, the CU Libraries site will be redesigned soon, and you don’t want to be left with dozens of broken links to fix!

This blog post explains how to format three types of hyperlinks:

  1. links to LibraryWeb non-secure pages
  2. links to external pages
  3. links to sections within a page

If you are editing a Text, Text & Image, or Table component:

  • To add a new link, highlight the desired link text and press the Hyperlink button Hyperlink button in the Rich Text Editor.
  • To view or modify a link using the Hyperlink dialog box, place your cursor over the link and press the Hyperlink button in the Rich Text Editor.

The Hyperlink dialog box will then appear:

Hyperlink Dialog Box

If you are not using a Text, Text & Image, or Table component for your links, and are using a List component instead, please note that additional formatting restrictions apply:

  • you can only include links that begin with /content/libraryweb
  • you must exclude the final .html from all URLs
  • you cannot use internal page references (URLs that end in #headingID)

1. Links to LibraryWeb non-secure pages

If you use the Browse Browse icon tool in the Hyperlink dialog box to locate pages in CQ, it will format links automatically with the correct /content/libraryweb prefix. But if you cut and paste a URL from the live LibraryWeb site into the dialog box, you will need to reformat it yourself into a relative link. 

You will also need to reformat LibraryWeb links using the Hyperlink dialog box if you have pasted in text from an e-mail or Word document that contains LibraryWeb links!

If you paste in a link to a page within LibraryWeb, replace the beginning of the path:

http://library.columbia.edu

with:

/content/libraryweb

For example, if you want to link to the CCOH home page,

http://library.columbia.edu/indiv/ccoh.html

you should provide the link in the Hyperlink dialog box in CQ as:

/content/libraryweb/indiv/ccoh.html

2. Links to external pages

All pages other than non-secure LibraryWeb pages are considered “external” to CQ. If you are linking to external pages, use a resolver URL for the page if one is available. 

It is important to use resolver URLs whenever possible so that when an external resource moves, all links to that resource can be updated quickly and centrally. It requires far more work to correct broken URLs scattered throughout LibraryWeb than to identify appropriate resolver URLs when you initially create links:

If no resolver URL is available, paste the full URL into the Hyperlink dialog box. Although it is possible to browse to LibraryWeb Secure Content and Alumni/Friends pages using the Browse button in the Hyperlink dialog box, the relative link that is created will not work.  Use the full URL!

Example: LibraryWeb Secure Content

To link to the Request a Reference Consultation page,

https://library.columbia.edu/requestit/reference/consultation.html

provide the link in the Hyperlink dialog box in CQ as the resolver URL:

http://www.columbia.edu/cgi-bin/cul/resolve?lweb0094

Example: Alumni/Friends

To link to the Alumni & Friends home page, provide the full URL:

https://alumni-friends.library.columbia.edu/

This will also apply to BTS and SWIFT pages once they are migrated to CQ.

Example: E-Resources

To link to JSTOR, provide the resolver URL:

http://www.columbia.edu/cgi-bin/cul/resolve?AMG1286

To link to the Chinese Paper Gods image collection, provide the resolver URL:

http://www.columbia.edu/cgi-bin/cul/resolve?clio5299290

Example: CLIO

To link to CLIO as a general catalog, use the resolver URL:

http://www.columbia.edu/cgi-bin/cul/resolve?clio

To link to a particular CLIO record, note the BIBID (e.g. 1234567) from the “Bookmark this page as” URL from the bottom of the record, and then reformat as follows:

http://www.columbia.edu/cgi-bin/cul/cliosearch?BIBID=1234567

3. Links to sections within a page

If you are linking to a section of another LibraryWeb non-secure page, use:

/content/libraryweb.../pagename.html#headingID

If you are linking to a section of the page you are working on, use:

#headingID

Note: if you do not use the correct formatting, when your page is moved during the redesign process, all of your internal page links will break!

For example, to link from another page to the Primary Source Materials section of Epigraphy Resources, which has the Heading ID primary, enter the following in the Hyperlink dialog box:

/content/libraryweb/indiv/papyrus/epigraphy.html#primary

But to link from within the page itself to its Primary Source Materials section, enter the following:

#primary

Questions

If you have questions about how to correctly format a link, or how to identify an appropriate resolver URL, please send an e-mail to the WCM Helpdesk.

Working with CourseWorks Guides in CQ

There are two types of CourseWorks guides: general subject guides and course-specific subject guides.

  • For a general subject guide, you will need the four-character department code (PHIL = Philosophy).
  • For a course-specific guide, you will need the four-character department code and the course number (HIST = History Department; course number G4000 Section 001). 

 Editing an existing guide is simple! Just log in to CQ and navigate to your guide (under CourseWorks in LibraryWeb).

To work with a general subject guide:

  1. Determine whether the department already has a section in the CourseWorks area. Most departments do. If the department has a section in this CourseWorks list, a "shell" for the general guide already exists.
    (If the department does not have a section, contact the WCM Helpdesk.)
  2. From the content tree (in the left portion of the Website Console), click on the department’s parent page (these top-level pages are place holders used to direct CourseWorks to the appropriate URL). A list of the child pages should appear in the Page Details panel to the right. If there is one listed with a name that is just the four-character department code (e.g., PHIL), that is the general guide for that area. Right click on the title to open and begin editing.

To create a course-specific guide:

  1. From the content tree, navigate to the department section in CourseWorks. Click on the parent page of the department to view its contents in the Page Details panel to the right.
  2. Select "New Page" from the drop-down menu at the top of that panel (above the title of the first page listed).
  3. Give your page a title that relates to the course.
  4. Name your page using the four-character department code (all caps!) and the course number: 
    HISTG4000
    NOTE: If you are creating different guides for different sections of the course, you will need to include the section number in the name too (e.g., HISTG4000003 for Section 003). Otherwise, the course sections will automatically link to the HISTG4000 guide.
  5. Click the Create button (the CourseWorks template is the default template in this section and should always be used).
  6. Your new guide should appear in the list in the Page Details panel.
  7. Right click on the new guide’s title, and select Open to begin editing.