https://docs-vrgeo-version3.netlify.app/assets/js/d398262f.3d88d9bd.js

1"use strict";(globalThis.webpackChunkvrgs_docs_v_3_1=globalThis.webpackChunkvrgs_docs_v_3_1||[]).push([[8763],{28710(e,n,i){i.r(n),i.d(n,{assets:()=>l,contentTitle:()=>d,default:()=>c,frontMatter:()=>o,metadata:()=>r,toc:()=>a});const r=JSON.parse('{"id":"ribbons/ribbon-html-editor","title":"HTML Editor Tab","description":"Commands on the HTML Editor ribbon tab, grouped by panel: Save, Editor Font, Formatting, Edit.","source":"@site/docs/ribbons/html-editor.md","sourceDirName":"ribbons","slug":"/ribbons/ribbon-html-editor","permalink":"/docs/next/ribbons/ribbon-html-editor","draft":false,"unlisted":false,"editUrl":"https://github.com/vrgeoscience/vrgs_docs_v3/tree/master/docs/ribbons/html-editor.md","tags":[],"version":"current","sidebarPosition":24,"frontMatter":{"id":"ribbon-html-editor","title":"HTML Editor Tab","description":"Commands on the HTML Editor ribbon tab, grouped by panel: Save, Editor Font, Formatting, Edit.","sidebar_label":"HTML Editor","sidebar_position":24},"sidebar":"docs","previous":{"title":"WWW","permalink":"/docs/next/ribbons/ribbon-www"},"next":{"title":"Python","permalink":"/docs/next/ribbons/ribbon-python"}}');var t=i(74848),s=i(28453);const o={id:"ribbon-html-editor",title:"HTML Editor Tab",description:"Commands on the HTML Editor ribbon tab, grouped by panel: Save, Editor Font, Formatting, Edit.",sidebar_label:"HTML Editor",sidebar_position:24},d="HTML Editor Ribbon Tab",l={},a=[{value:"Save",id:"save",level:2},{value:"Save HTML",id:"save-html",level:3},{value:"Editor Font",id:"editor-font",level:2},{value:"Formatting",id:"formatting",level:2},{value:"Prettify",id:"prettify",level:3},{value:"Character formatting",id:"character-formatting",level:3},{value:"Lists, links and images",id:"lists-links-and-images",level:3},{value:"Headings",id:"headings",level:3},{value:"Edit",id:"edit",level:2}];function h(e){const n={a:"a",admonition:"admonition",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",header:"header",li:"li",p:"p",strong:"strong",ul:"ul",...(0,s.R)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.header,{children:(0,t.jsx)(n.h1,{id:"html-editor-ribbon-tab",children:"HTML Editor Ribbon Tab"})}),"\n",(0,t.jsx)(n.p,{children:(0,t.jsxs)(n.em,{children:["Context-sensitive tab \u2014 appears when the ",(0,t.jsx)(n.strong,{children:"HTML Editor"})," context is active."]})}),"\n",(0,t.jsxs)(n.p,{children:["Commands available on the ",(0,t.jsx)(n.strong,{children:"HTML Editor"})," ribbon tab, grouped by panel."]}),"\n",(0,t.jsxs)(n.admonition,{title:"Most editing happens in the editor's own toolbar",type:"info",children:[(0,t.jsxs)(n.p,{children:["Field guide pages and analysis reports are edited in a ",(0,t.jsx)(n.strong,{children:"WYSIWYG editor"})," whose\ntoolbar sits above the page \u2014 that is where you will find fonts, colours,\nalignment, tables, callouts, quizzes, VRGS links, maps, media and (in a report)\nfigures and PDF export. This ribbon tab carries a handful of the same formatting\ncommands so they can be reached from the ribbon, plus ",(0,t.jsx)(n.strong,{children:"Save"}),"."]}),(0,t.jsxs)(n.p,{children:["See the ",(0,t.jsx)(n.a,{href:"/docs/next/general/viewing-collaboration/field-guide-editor",children:"Virtual Field Guide Editor"}),"\nand ",(0,t.jsx)(n.a,{href:"/docs/next/general/viewing-collaboration/report-view",children:"Analysis Reports"})," guides."]})]}),"\n",(0,t.jsx)(n.h2,{id:"save",children:"Save"}),"\n",(0,t.jsx)(n.h3,{id:"save-html",children:"Save HTML"}),"\n","\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"Tooltip:"})," Save HTML"]}),"\n",(0,t.jsxs)(n.p,{children:["Save the current page. ",(0,t.jsx)(n.strong,{children:"Ctrl+S"})," does the same, and so does the \ud83d\udcbe button on the\neditor's own toolbar. A previous version of the page is kept, so an earlier save\ncan be recovered with ",(0,t.jsx)(n.strong,{children:"Restore Previous Version\u2026"})," in the editor's Guide sidebar."]}),"\n",(0,t.jsx)(n.h2,{id:"editor-font",children:"Editor Font"}),"\n",(0,t.jsxs)(n.p,{children:["The controls in this panel \u2014 ",(0,t.jsx)(n.strong,{children:"Increase Size"}),", ",(0,t.jsx)(n.strong,{children:"Decrease Size"}),", ",(0,t.jsx)(n.strong,{children:"Font"}),",\n",(0,t.jsx)(n.strong,{children:"Line Numbers"}),", ",(0,t.jsx)(n.strong,{children:"Indenting"}),", ",(0,t.jsx)(n.strong,{children:"Use XHTML"})," and ",(0,t.jsx)(n.strong,{children:"Auto Complete"})," \u2014 belong to\nthe older plain-text HTML source editor and do nothing in the WYSIWYG editor. Set\nfonts and sizes from the editor's own toolbar instead; to work on the markup\ndirectly, use the toolbar's ",(0,t.jsx)(n.strong,{children:"</>"})," source toggle."]}),"\n",(0,t.jsx)(n.h2,{id:"formatting",children:"Formatting"}),"\n",(0,t.jsx)(n.p,{children:"These commands act on the current selection in the WYSIWYG editor, and are\nmirrors of the editor's own toolbar buttons."}),"\n",(0,t.jsx)(n.h3,{id:"prettify",children:"Prettify"}),"\n","\n",(0,t.jsx)(n.p,{children:"Reformats raw HTML source. Legacy \u2014 it has no effect in the WYSIWYG editor."}),"\n",(0,t.jsx)(n.h3,{id:"character-formatting",children:"Character formatting"}),"\n",(0,t.jsx)(n.p,{children:"Dropdown items:"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Button"})," \u2014 Bold ",(0,t.jsxs)(n.em,{children:["(",(0,t.jsx)(n.code,{children:"ID_HTMLVIEW_FONTBOLD"}),")"]})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Button"})," \u2014 Italic ",(0,t.jsxs)(n.em,{children:["(",(0,t.jsx)(n.code,{children:"ID_HTMLVIEW_FONTITALIC"}),")"]})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Button"})," \u2014 Underline ",(0,t.jsxs)(n.em,{children:["(",(0,t.jsx)(n.code,{children:"ID_HTMLVIEW_FONTUNDERLINE"}),")"]})]}),"\n"]}),"\n",(0,t.jsx)(n.h3,{id:"lists-links-and-images",children:"Lists, links and images"}),"\n",(0,t.jsx)(n.p,{children:"Dropdown items:"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Unordered List"})," \u2014 Create a bulleted list from the selection ",(0,t.jsxs)(n.em,{children:["(",(0,t.jsx)(n.code,{children:"ID_HTMLVIEW_LISTTAG"}),")"]})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Ordered List"})," \u2014 Create a numbered list from the selection ",(0,t.jsxs)(n.em,{children:["(",(0,t.jsx)(n.code,{children:"ID_HTMLVIEW_ORDEREDLISTTAG"}),")"]})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Link"})," \u2014 Insert a hyperlink ",(0,t.jsxs)(n.em,{children:["(",(0,t.jsx)(n.code,{children:"ID_HTMLVIEW_WEBLINK"}),")"]})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"image"})," \u2014 Insert an image ",(0,t.jsxs)(n.em,{children:["(",(0,t.jsx)(n.code,{children:"ID_HTMLVIEW_IMAGE"}),")"]})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Remove Formatting"})," \u2014 Strip formatting from the selection ",(0,t.jsxs)(n.em,{children:["(",(0,t.jsx)(n.code,{children:"ID_HTMLVIEW_CLEARFORMATTING"}),")"]})]}),"\n"]}),"\n",(0,t.jsx)(n.admonition,{type:"tip",children:(0,t.jsxs)(n.p,{children:["For a link that acts on the 3D scene \u2014 flying the camera to a viewpoint, or\nstarting a flight path \u2014 use the editor toolbar's ",(0,t.jsx)(n.strong,{children:"Insert \u2192 VRGS Link"})," rather\nthan this plain hyperlink."]})}),"\n",(0,t.jsx)(n.h3,{id:"headings",children:"Headings"}),"\n",(0,t.jsx)(n.p,{children:"Dropdown items:"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"h1"})," \u2014 Heading 1 ",(0,t.jsxs)(n.em,{children:["(",(0,t.jsx)(n.code,{children:"ID_HTMLVIEW_HEADER1"}),")"]})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"h2"})," \u2014 Heading 2 ",(0,t.jsxs)(n.em,{children:["(",(0,t.jsx)(n.code,{children:"ID_HTMLVIEW_HEADER2"}),")"]})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"h3"})," \u2014 Heading 3 ",(0,t.jsxs)(n.em,{children:["(",(0,t.jsx)(n.code,{children:"ID_HTMLVIEW_HEADER3"}),")"]})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"h4"})," \u2014 Heading 4 ",(0,t.jsxs)(n.em,{children:["(",(0,t.jsx)(n.code,{children:"ID_HTMLVIEW_HEADER4"}),")"]})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"h5"})," \u2014 Heading 5 ",(0,t.jsxs)(n.em,{children:["(",(0,t.jsx)(n.code,{children:"ID_HTMLVIEW_HEADER5"}),")"]})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"h6"})," \u2014 Heading 6 ",(0,t.jsxs)(n.em,{children:["(",(0,t.jsx)(n.code,{children:"ID_HTMLVIEW_HEADER6"}),")"]})]}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["Headings are also what the editor's ",(0,t.jsx)(n.strong,{children:"This page"}

1)," outline, a page's ",(0,t.jsx)(n.strong,{children:"Table of\nContents"})," block and a report's table of contents are built from, so they are\nworth using rather than large bold text."]}),"\n",(0,t.jsx)(n.h2,{id:"edit",children:"Edit"}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"Find"})," ",(0,t.jsxs)(n.em,{children:["(",(0,t.jsx)(n.code,{children:"ID_HTMLVIEW_FIND"}),")"]})," and ",(0,t.jsx)(n.strong,{children:"Replace"})," ",(0,t.jsxs)(n.em,{children:["(",(0,t.jsx)(n.code,{children:"ID_HTMLVIEW_REPLACE"}),")"]})," belong\nto the plain-text source editor. In the WYSIWYG editor use the WebView's own find\n(",(0,t.jsx)(n.strong,{children:"Ctrl+F"}),")."]}),"\n",(0,t.jsxs)(n.p,{children:["Undo and redo are ",(0,t.jsx)(n.strong,{children:"Ctrl+Z"})," / ",(0,t.jsx)(n.strong,{children:"Ctrl+Y"}),", or the \u21a9 / \u21aa buttons on the editor\ntoolbar."]})]})}function c(e={}){const{wrapper:n}={...(0,s.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(h,{...e})}):h(e)}},28453(e,n,i){i.d(n,{R:()=>o,x:()=>d});var r=i(96540);const t={},s=r.createContext(t);function o(e){const n=r.useContext(s);return r.useMemo(function(){return"function"==typeof e?e(n):{...n,...e}},[n,e])}function d(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:o(e.components),r.createElement(s.Provider,{value:n},e.children)}}}]);