stc summit 2015 hypergraphics for visual-first help

23
ts" > l ="#74B74A" points="356 ill="#FFFFFF" stroke="#000000 -6.627,5.373-12,12-12h230c6.627,0,1 <path fill="#D1D3D4" d ="M1105.136,1417 c0-6.627,5.372-12,12-12 h1037.947c6.628, <path fill ="#E7E8E9" d ="M1095.617,1407. c6.627,0,12,5.373,12,12V1407.654z" /> <path fill="#E7E8E9" d="M546.617,1408.654 c6.627,0,12,5.373,12,12 V1408.654z"/> <g> <g> <line fill="none" stroke="#000000" stroke-wi <polygon po ints="495.856,1308.229 501.0 58,129 </g> </g> <g> <g> <script type ="text/javascript" > <![CDATA[ f unction bktitle() { v ar bktitle = window.open ("PDF-bookimprintpage -bktitle.xhtml","bktitle","r bktitle.focus(); return false; } ypergraphics for ypergraphics for isual-first help isual-first help VG, CSS, JavaScrip VG, CSS, JavaScrip Dave Gardiner

Upload: dave-gardiner

Post on 08-Aug-2015

206 views

Category:

Technology


4 download

TRANSCRIPT

Page 1: STC Summit 2015 Hypergraphics for visual-first help

<g id="page_elements">

<polyline fill="#74B74A" points="356.13,126.07 338.659,143.612 321.13,126.07 "/>

<path fill="#FFFFFF" stroke="#000000" d="M365.617,114.654c0,6.627-5.373,12-12,12h-230c-6.627,0-12-5.373-12-12v-7.5

c0-6.627,5.373-12,12-12h230c6.627,0,12,5.373,12,12V114.654z"/>

<path fill="#D1D3D4" d="M1105.136,1417.218c0,6.627-5.372,12-12,12H55.188c-6.628,0-12-5.373-12-12v-124.493

c0-6.627,5.372-12,12-12h1037.947c6.628,0,12,5.373,12,12V1417.218z"/>

<path fill="#E7E8E9" d="M1095.617,1407.654c0,6.627-5.373,12-12,12h-469c-6.627,0-12-5.373-12-12v-81c0-6.627,5.373-12,12-12h469

c6.627,0,12,5.373,12,12V1407.654z"/>

<path fill="#E7E8E9" d="M546.617,1408.654c0,6.627-5.373,12-12,12h-469c-6.627,0-12-5.373-12-12v-81c0-6.627,5.373-12,12-12h469

c6.627,0,12,5.373,12,12V1408.654z"/>

<g><g><line fill="none" stroke="#000000" stroke-width="5" x1="510.764" y1="1293.321" x2="502.097" y2="1301.988"/>

<polygon points="495.856,1308.229 501.058,1295.842 502.563,1301.521 508.243,1303.027 "/>

</g></g><g><g><script type="text/javascript">

<![CDATA[ function bktitle() {

var bktitle = window.open

("PDF-bookimprintpage-bktitle.xhtml","bktitle","resizable=yes,width=500,height=220,left=100,top=100,scrollbars=yes");

bktitle.focus();

return false;

}

Hypergraphics for Hypergraphics for visual-first helpvisual-first help

SVG, CSS, JavaScriptSVG, CSS, JavaScriptDave Gardiner

Page 2: STC Summit 2015 Hypergraphics for visual-first help

What’s happening in tech comm?What’s happening in tech comm?

2/23#stc15

Page 3: STC Summit 2015 Hypergraphics for visual-first help

3/23#stc15Image: David Sandonato / 123RF

““Interactive Interactive infographics”infographics”

(But “hypergraphics” (But “hypergraphics” sounds more “techie/geeky”)sounds more “techie/geeky”)

Page 4: STC Summit 2015 Hypergraphics for visual-first help

Take a closer look at …Take a closer look at …

4/23

<section>

<header>

http://www.w3schools.com/htmL/html5_new_elements.asp

New semantic elements

<audio>

<track><video>

New media elements

<canvas><svg>

New graphics elements

#stc15

<nav>

Page 5: STC Summit 2015 Hypergraphics for visual-first help

HTML5 SVGHTML5 SVG

5/23http://www.w3schools.com/htmL/html5_svg.asp

#stc15

… It’s a high-quality graphics format for displaying interactive sketches

and technical illustrations

Page 6: STC Summit 2015 Hypergraphics for visual-first help

What’s in it for technical communication?What’s in it for technical communication?

6/23#stc15

Can be done with SVG

You want mobile-first docs

You’ve seen touch gestures for web apps How about interactive documentation for a similar user experience?

And created with cost- effective graphic design tools

Page 7: STC Summit 2015 Hypergraphics for visual-first help

7/23

Emerging trends, emerging challengesEmerging trends, emerging challenges

“We need an alternative way to display tables

on mobile devices”Charles Cooper & Ann Rockley, STC Summit 2014

#stc15

Page 8: STC Summit 2015 Hypergraphics for visual-first help

8/23

Otherwise…Otherwise…

#stc15

Page 9: STC Summit 2015 Hypergraphics for visual-first help

9/23

Reformat tables into web topicsReformat tables into web topics Fragment into web topics

Create visual interfaces

#stc15

Page 10: STC Summit 2015 Hypergraphics for visual-first help

Cool idea #1: Hypergraphic web topicsCool idea #1: Hypergraphic web topics

10/23

Online help document with links to hypergraphics for accessing reference info and procedures

Hypergraphics link to standalone web topics for online help

#stc15

Page 11: STC Summit 2015 Hypergraphics for visual-first help

What’s under the hood …What’s under the hood …

11/23

It’s text, just like HTML5 Use a text editor to add CSS styles & interactive HTML elements

<?xml version="1.0" encoding="utf-8"?><svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" width="1212.553px" height="640px" viewBox="0 0 1212.553 1600" preserveAspectRatio="xMidYMid meet"><defs><style type="text/css"><![CDATA[svg {width: 99%;height: 99%;position: relative;top: 0;left: 0; #stc15

Page 12: STC Summit 2015 Hypergraphics for visual-first help

Hyperlinking in SVGHyperlinking in SVG

12/23

<a xlink:href="PDF-chaptitlepage-chaptitle.xhtml"

xlink:title="Chapter title"

onclick="return chaptitle('chaptitle')">

<text class="overlay" transform="matrix(1 0 0 1

325.3223 297.1016)" fill="#ED1C24" font-

family="'ArialMT'" font-size="36">Title of

Chapter</text>

</a> HTML linkingHTML linking

Javascript eventsJavascript eventsfunction chaptitle() { var chaptitle = window.open ("PDF-chaptitlepage-chaptitle.xhtml", "chaptitle", "resizable=yes,width=500,height=410,left=100,top=100,scrollbars=yes"); chaptitle.focus(); return false; }

#stc15

Page 13: STC Summit 2015 Hypergraphics for visual-first help

CSS3 media queriesCSS3 media queries

13/23

@media screen and (orientation: landscape) {#smallscreen {display: none;}}@media screen and (orientation: landscape) {#bigscreen {width: 30%;height: 80%;}}@media screen and (orientation: portrait) {#bigscreen {display: none;}}@media screen and (orientation: portrait) {#smallscreen {width: 80%;}}

Modify the style/display of whole or parts of graphics Reference ID or class values of SVG elements in the CSS Set breakpoints, orientation, device aspect ratio …

Incorporates RWD:

http://www.smashingmagazine.com/2014/03/05/rethinking-responsive-svg/

Display, resize, …

display: none/block/inline

fluid grid – resize to browser width/height

#stc15

Page 14: STC Summit 2015 Hypergraphics for visual-first help

14/23

Cool idea #2: Translation / localizationCool idea #2: Translation / localization SVG <switch> element changes language based on a user’s browser settings

‘Single-source’ graphics for global markets – draw once, use in many places (multilingual)

#stc15

Page 15: STC Summit 2015 Hypergraphics for visual-first help

JavaScript for interactivityJavaScript for interactivity

15/23

JavaScript functions and libraries extend interactive functionality (animations, touch gestures, draggable objects …)

#stc15

Page 16: STC Summit 2015 Hypergraphics for visual-first help

Even further with jQueryEven further with jQuery

16/23

External SVG file is referenced in an HTML5 page

HTML5 pages are the basis for documentation (i.e. for navigation, accessibility, metadata, SEO) Hypergraphics can ‘talk’ to jQuery (integrate interactive sketches with mobile help)

#stc15

Page 17: STC Summit 2015 Hypergraphics for visual-first help

17/23

+ JavaScript to open external HTML files in <div>

Export SVG from illustration tools + <a xlink:href> for hyperlinking + <title> and <desc> for screen reader accessibility

+ jQuery to use interactive SVG within HTML5 files, and responsive web design

Cool idea #3: Visual mobile-first docsCool idea #3: Visual mobile-first docs

#stc15

Page 18: STC Summit 2015 Hypergraphics for visual-first help

Best viewed with …Best viewed with …

18/23

Varies depending on CSS, JS, fonts, styling, video

Firefox

IE

HTML5 title and desc ARIA attributes in SVG

× Screen reader support poor/inconsistent

(NVDA in FF locally, Chrome online, mobile)

No one tool does everything CorelDRAW / Illustrator produce clean markup, ‘OK’ SVG output options

×Most ‘SVG editor’ tools produce inline CSS styles

Opera (Andr.), Chrome

×Proprietary ns declaration

Some hand-coding to implement JS and SVG functionality

Several tools – graphics, JS editor, SVG optimiser

jQuery libraries for touch gestures are promising

#stc15

Page 19: STC Summit 2015 Hypergraphics for visual-first help

What this means for information designWhat this means for information design

19/23

#stc15

Retain existing information architecture,add a visual interface to ‘restructure’

what users interact with

Minimize interaction with complex hierarchical document structures that

are a barrier to finding information

Page 20: STC Summit 2015 Hypergraphics for visual-first help

20/23#stc15

SVG - A more direct route from task/SVG - A more direct route from task/workflow sketches to user interfaces?workflow sketches to user interfaces?

Page 21: STC Summit 2015 Hypergraphics for visual-first help

So… why use hypergraphics?So… why use hypergraphics?

21/23

What’s big in tech comm …

What SVG hypergraphics offer …

HTML5 • A web tool that integrates with online help

CSS3 • Use media queries, animations and many CSS styles

Responsive web design • Graphics resize to fit device screen • Display and style content depending on device

specs, orientation, browser size…

Infographics / sketching • Finally, graphics and sketches are put to good use with interactivity (illustration tools can output SVG)

Video / rich media • A place to embed videos with interactive illustrations

Mobile-first • Integrates with JavaScript, jQuery elements• “Work in progress” to automate implementation

of coding

User experience (UX) • Restructure information architecture into task-based interfaces

• Combines several web technologies into engaging experiences that make learning easier

#stc15

Page 22: STC Summit 2015 Hypergraphics for visual-first help

Today ... Today ...

22/23#stc15

SVG 1.1 + editing toolchain

Håkan Dahlström / Wikimedia Commons 

SVG 2 + JS/HTML graphics editor

+3 years+3 years

Page 23: STC Summit 2015 Hypergraphics for visual-first help

23/23

W: xmplar.bizE: [email protected]: @copebooxSk: copeboox1M: +61-424 003020

Questions?Questions?

#stc15

svgdocs.net