Intelligently replaces Unicode ligatures in a PDF text extraction.
Parameters
key
value
description
type (required)
ligature
mappings (required)
object
An object mapping ligature strings (for example, “\u0000”) to an array of possible ligature replacements (for example, [“ff”, “ffi”, “fi”, “fl”]). Sensible uses a dictionary in the target language to choose replacements that lead to known words. Sensible supports American English (en-us). This approach is conservative and may leave some Unicode characters in proper names or other non-word data.
forceReplaceAll
false
If true, specifies to bypass the dictionary lookup and to replace each ligature with the first replacement listed in the mappings array. This is useful in situations where words containing ligatures are not in the supported dictionary. For example, they are in an unsupported language or are proper nouns.
Examples
This config shows using a Ligature preprocessor and outputting the whole document to check the ligature replacement accuracy:
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Sensible","colors":{"primary":"#4B0532","light":"#611646","dark":"#4B0532"},"favicon":"/favicon.png","logo":{"light":"https://mintlify.s3-us-west-1.amazonaws.com/sensible/logo/light.png","dark":"https://mintlify.s3-us-west-1.amazonaws.com/sensible/logo/dark.png"},"navbar":{"links":[{"label":"Sign In","href":"https://app.sensible.so/signin/"}],"primary":{"type":"button","label":"Try Sensible","href":"https://app.sensible.so/register/"}},"footer":{"socials":{"twitter":"https://twitter.com/sensiblehq","linkedin":"https://www.linkedin.com/company/usesensible/"}},"navigation":{"global":{"anchors":[{"anchor":"Tutorials","href":"https://www.sensible.so/learn","icon":"book-open"},{"anchor":"API Status","href":"https://sensible.statuspage.io/","icon":"signal-bars"},{"anchor":"Blog","href":"https://www.sensible.so/blog","icon":"newspaper"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sensible","hasAudioNarration":false,"actualSubdomain":"sensible","customDomains":[],"gitSource":{"type":"github","owner":"sensible-hq","repo":"test-sensible-refactor-upgrade","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae91e75695ee6f94e42be39:success","clientVersion":"0.0.4160","searchFilterCounts":[{"language":"default","tag":"Documentation","count":124},{"language":"default","tag":"SenseML Reference","count":84},{"language":"default","tag":"API Reference","count":38},{"language":"default","tag":"Configuration","count":30},{"language":"default","tag":"Methods","count":16},{"language":"default","tag":"Concepts","count":14},{"language":"default","tag":"Extraction","count":13},{"language":"default","tag":"Changelog","count":12},{"language":"default","tag":"Preprocessors","count":12},{"language":"default","tag":"Best Practices","count":11}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"senseml-reference/preprocessors/ligature","slug":"/senseml-reference/preprocessors/ligature","pageMetadata":{"title":"Ligature","description":null,"href":"/senseml-reference/preprocessors/ligature"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Intelligently replaces Unicode `,_jsx(_components.a,{href:`/senseml-reference/preprocessors/ligature`,children:`ligatures`}),` in a PDF text extraction.`]}),`\n`,_jsx(Heading,{level:`3`,id:`parameters`,children:`Parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`key`}),_jsx(_components.th,{children:`value`}),_jsx(_components.th,{children:`description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`type (`,_jsx(_components.strong,{children:`required`}),`)`]}),_jsx(_components.td,{children:`ligature`}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`mappings (`,_jsx(_components.strong,{children:`required`}),`)`]}),_jsx(_components.td,{children:`object`}),_jsx(_components.td,{children:`An object mapping ligature strings (for example, “\\\\u0000”) to an array of possible ligature replacements (for example, [“ff”, “ffi”, “fi”, “fl”]). Sensible uses a dictionary in the target language to choose replacements that lead to known words. Sensible supports American English (en-us). This approach is conservative and may leave some Unicode characters in proper names or other non-word data.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`forceReplaceAll`}),_jsx(_components.td,{children:`false`}),_jsx(_components.td,{children:`If true, specifies to bypass the dictionary lookup and to replace each ligature with the first replacement listed in the mappings array. This is useful in situations where words containing ligatures are not in the supported dictionary. For example, they are in an unsupported language or are proper nouns.`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`examples`,children:`Examples`}),`\n`,_jsx(_components.p,{children:`This config shows using a Ligature preprocessor and outputting the whole document to check the ligature replacement accuracy:`}),`\n`,_jsx(CodeBlock,{filename:`JSON`,numberOfLines:`33`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`33`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"preprocessors\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ligature\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mappings\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\u0000`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"ff\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"fi\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"fl\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\u0001`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"ti\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"tl\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"fields\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"all_lines_in_doc\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"method\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"documentRange\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"includeAnchor\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"anchor\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"match\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"first\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:\"`\"})}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Ligature","description":null,"href":"/senseml-reference/preprocessors/ligature"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Parameters","slug":"parameters","depth":3,"children":[]},{"title":"Examples","slug":"examples","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/sensible/bc07317c9f569894/script.js"],"subdomain":"sensible","siteName":"Sensible","title":"Ligature - Sensible","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"senseml-reference/preprocessors/ligature.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Sensible\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/sensible/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/sensible/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/sensible/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/sensible/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Ligature - Sensible\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sensible\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://sensible.mintlify.app/senseml-reference/preprocessors/ligature\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sensible.mintlify.site/_mintlify/api/og/v2?division=Preprocessors\u0026amp;title=Ligature\u0026amp;theme=8c220aab359c87e50aa52132\u0026amp;signature=2f5165b975dad31d3d68d5cb87a2a83c8af8ce8203d198294cd620497f763054\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Ligature - Sensible\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sensible.mintlify.site/_mintlify/api/og/v2?division=Preprocessors\u0026amp;title=Ligature\u0026amp;theme=8c220aab359c87e50aa52132\u0026amp;signature=2f5165b975dad31d3d68d5cb87a2a83c8af8ce8203d198294cd620497f763054\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/sensible/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sensible\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4B0532\">\u003clink data-mint-head rel=\"canonical\" href=\"https://sensible.mintlify.app/senseml-reference/preprocessors/ligature\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/senseml-reference/preprocessors/ligature.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://sensible.mintlify.app/#organization\",\"name\":\"Sensible\",\"url\":\"https://sensible.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintlify.s3-us-west-1.amazonaws.com/sensible/logo/light.png\"}},{\"@type\":\"WebSite\",\"@id\":\"https://sensible.mintlify.app#website\",\"name\":\"Sensible\",\"url\":\"https://sensible.mintlify.app\",\"publisher\":{\"@id\":\"https://sensible.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://sensible.mintlify.app/senseml-reference/preprocessors/ligature#webpage\",\"url\":\"https://sensible.mintlify.app/senseml-reference/preprocessors/ligature\",\"name\":\"Ligature\",\"isPartOf\":{\"@id\":\"https://sensible.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://sensible.mintlify.app/senseml-reference/preprocessors/ligature#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://sensible.mintlify.app/senseml-reference/preprocessors/ligature#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"SenseML Reference\",\"item\":\"https://sensible.mintlify.app/senseml-reference/senseml-reference-introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Preprocessors\",\"item\":\"https://sensible.mintlify.app/senseml-reference/preprocessors/index-preprocessors\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Ligature\",\"item\":\"https://sensible.mintlify.app/senseml-reference/preprocessors/ligature\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://sensible.mintlify.app/senseml-reference/preprocessors/ligature#article\",\"headline\":\"Ligature\",\"name\":\"Ligature\",\"url\":\"https://sensible.mintlify.app/senseml-reference/preprocessors/ligature\",\"mainEntityOfPage\":{\"@id\":\"https://sensible.mintlify.app/senseml-reference/preprocessors/ligature#webpage\"},\"publisher\":{\"@id\":\"https://sensible.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://sensible.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sensible\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Sensible\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/senseml-reference/preprocessors/ligature.md","siteName":"Sensible","nav":{"global":{"anchors":[{"anchor":"Tutorials","href":"https://www.sensible.so/learn","icon":"book-open"},{"anchor":"API Status","href":"https://sensible.statuspage.io/","icon":"signal-bars"},{"anchor":"Blog","href":"https://www.sensible.so/blog","icon":"newspaper"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Welcome","pages":[{"title":"Getting started","href":"/welcome/getting-started-ai"},{"title":"Integrating","href":"/welcome/integrate"},{"title":"Choosing an extraction approach","href":"/welcome/author"}]},{"group":"Integrations","pages":[{"title":"SDK guides","href":"/integrations/sdk-guides"},{"group":"Zapier Overview","pages":[{"title":"Zapier overview","sidebarTitle":"Overview","href":"/integrations/zapier/index-zapier"},{"title":"Zapier tutorial","href":"/integrations/zapier/zapier-getting-started"},{"title":"Advanced Zapier tutorial","href":"/integrations/zapier/zapier-tutorial-2"}]},{"title":"API quickstart","href":"/integrations/quickstart"},{"group":"Quick Extraction","pages":[{"title":"Quick extraction","sidebarTitle":"Overview","href":"/integrations/quick-extraction/index-quick-extraction"},{"title":"SenseML to spreadsheet reference","href":"/integrations/quick-extraction/excel-reference"}]}]},{"group":"LLM-based Extractions","pages":[{"group":"Prompt Tips","pages":[{"title":"Prompt tips","sidebarTitle":"Overview","href":"/llm-based-extractions/prompt-tips/index-prompt-tips"},{"title":"Query group extraction tips","href":"/llm-based-extractions/prompt-tips/query-group-tips"},{"title":"List tips","href":"/llm-based-extractions/prompt-tips/list-tips"},{"title":"NLP table extraction tips","href":"/llm-based-extractions/prompt-tips/table-tips"}]},{"title":"Advanced prompt configuration","href":"/llm-based-extractions/prompt"}]},{"group":"Layout-based Extractions","pages":[{"title":"Getting started with layout-based extractions","href":"/layout-based-extractions/getting-started"},{"title":"Out-of-the-box extractions","href":"/layout-based-extractions/library-quickstart"},{"title":"Multi-document extractions","href":"/layout-based-extractions/portfolio"},{"title":"Repeating layouts","href":"/layout-based-extractions/repeat-layouts"},{"group":"App Guide","pages":[{"title":"App guide","sidebarTitle":"Overview","href":"/layout-based-extractions/app-guide/index-app-guide"},{"title":"Color coding","href":"/layout-based-extractions/app-guide/color"},{"title":"Sensible walkthrough","href":"/layout-based-extractions/app-guide/ui"}]}]},{"group":"Document Type Classification","pages":[{"title":"Classifying documents by type","href":"/document-type-classification/classify"}]},{"group":"Best Practices","pages":[{"title":"Troubleshooting LLM extractions","href":"/best-practices/troubleshoot-llms"},{"title":"Monitoring extractions","href":"/best-practices/metrics"},{"title":"Qualifying LLM accuracy","href":"/best-practices/confidence"},{"title":"Validating extractions","href":"/best-practices/validate-extractions"},{"group":"Tutorials","pages":[{"title":"Tutorials","sidebarTitle":"Overview","href":"/best-practices/tutorials/index-tutorials"},{"title":"Using fallbacks","href":"/best-practices/tutorials/fallbacks"},{"title":"Optimizing extraction performance","href":"/best-practices/tutorials/performance"},{"title":"Testing before integrating configs","href":"/best-practices/tutorials/test-before-integrating-configs"},{"title":"Troubleshooting","href":"/best-practices/tutorials/troubleshoot"},{"title":"Extracting handwriting and OCR text","href":"/best-practices/tutorials/handwriting"},{"title":"Go-live checklist","href":"/best-practices/tutorials/go-live"}]}]},{"group":"SenseML Reference","pages":[{"title":"SenseML reference introduction","href":"/senseml-reference/senseml-reference-introduction"},{"group":"Field Query Object","pages":[{"title":"Field query object","sidebarTitle":"Overview","href":"/senseml-reference/field-query-object/index-field-query-object"},{"title":"Anchor object","href":"/senseml-reference/field-query-object/anchor"},{"title":"Match object","href":"/senseml-reference/field-query-object/match"},{"title":"Method object","href":"/senseml-reference/field-query-object/method"},{"title":"Types","href":"/senseml-reference/field-query-object/types"}]},{"group":"Methods","pages":[{"title":"Methods","sidebarTitle":"Overview","href":"/senseml-reference/methods/index-methods"},{"title":"Box","href":"/senseml-reference/methods/box"},{"title":"Checkbox","href":"/senseml-reference/methods/checkbox"},{"title":"Column","href":"/senseml-reference/methods/column"},{"title":"Document range","href":"/senseml-reference/methods/document-range"},{"title":"Fixed table","href":"/senseml-reference/methods/fixed-table"},{"title":"Label","href":"/senseml-reference/methods/label"},{"title":"Intersection","href":"/senseml-reference/methods/intersection"},{"title":"Nearest checkbox","href":"/senseml-reference/methods/nearest-checkbox"},{"title":"Paragraph","href":"/senseml-reference/methods/paragraph"},{"title":"Passthrough","href":"/senseml-reference/methods/passthrough"},{"title":"Regex","href":"/senseml-reference/methods/regex"},{"title":"Region","href":"/senseml-reference/methods/region"},{"title":"Row","href":"/senseml-reference/methods/row"},{"title":"Signature","href":"/senseml-reference/methods/signature"},{"title":"Text Table","href":"/senseml-reference/methods/text-table"}]},{"group":"LLM based methods","pages":[{"title":"LLM-based methods","sidebarTitle":"Overview","href":"/senseml-reference/llm-based-methods/index-llm-based-methods"},{"title":"List","href":"/senseml-reference/llm-based-methods/list"},{"title":"NLP table","href":"/senseml-reference/llm-based-methods/nlp-table"},{"title":"Query group","href":"/senseml-reference/llm-based-methods/query-group"},{"title":"Summarizer","href":"/senseml-reference/llm-based-methods/summarizer"}]},{"group":"Preprocessors","pages":[{"title":"Preprocessors","sidebarTitle":"Overview","href":"/senseml-reference/preprocessors/index-preprocessors"},{"title":"Deskew","description":null,"href":"/senseml-reference/preprocessors/deskew"},{"title":"Ligature","href":"/senseml-reference/preprocessors/ligature"},{"title":"Merge lines","description":null,"href":"/senseml-reference/preprocessors/merge-lines"},{"title":"NLP","href":"/senseml-reference/preprocessors/nlp"},{"title":"OCR preprocessor","href":"/senseml-reference/preprocessors/ocr-preprocessor"},{"title":"Page range","href":"/senseml-reference/preprocessors/page-range"},{"title":"Remove footer","href":"/senseml-reference/preprocessors/remove-footer"},{"title":"Remove header","href":"/senseml-reference/preprocessors/remove-header"},{"title":"Rotate page","href":"/senseml-reference/preprocessors/rotate-page"},{"title":"Scale","href":"/senseml-reference/preprocessors/scale"},{"title":"Split lines","href":"/senseml-reference/preprocessors/split-lines"}]},{"group":"Computed Field Methods","pages":[{"title":"Computed field methods","sidebarTitle":"Overview","href":"/senseml-reference/computed-field-methods/index-computed-field-methods"},{"title":"Concatenate","href":"/senseml-reference/computed-field-methods/concatenate"},{"title":"Constant","href":"/senseml-reference/computed-field-methods/constant"},{"title":"Mapper","href":"/senseml-reference/computed-field-methods/mapper"},{"title":"Pick values","href":"/senseml-reference/computed-field-methods/pick-values"},{"title":"Split","href":"/senseml-reference/computed-field-methods/split"},{"title":"Suppress output","href":"/senseml-reference/computed-field-methods/suppress-output"},{"title":"Zip","href":"/senseml-reference/computed-field-methods/zip"}]},{"group":"Sections","pages":[{"title":"Sections","sidebarTitle":"Overview","href":"/senseml-reference/sections/index-sections"},{"title":"Claims loss run example","href":"/senseml-reference/sections/sections-example-loss-run"},{"title":"Labeled rows example","href":"/senseml-reference/sections/sections-example-labeled-rows"},{"title":"Advanced: nested columns example","href":"/senseml-reference/sections/sections-example-nested-columns"},{"title":"Advanced: nested table example","href":"/senseml-reference/sections/sections-example-nested-table"},{"title":"Advanced: Table grid example","href":"/senseml-reference/sections/sections-example-table-grid"},{"title":"Advanced: Zip sections","href":"/senseml-reference/sections/sections-example-zip"},{"title":"Advanced: Zip and flatten nested sections","href":"/senseml-reference/sections/sections-example-copy-from-sections"},{"title":"Advanced: Transform sections data","href":"/senseml-reference/sections/sections-example-copy-to-section"},{"title":"Advanced: External anchors for sections","href":"/senseml-reference/sections/sections-example-external-range"}]},{"group":"Config Settings","pages":[{"title":"Config settings","sidebarTitle":"Overview","href":"/senseml-reference/config-settings/index-config-settings"},{"title":"Fingerprint","href":"/senseml-reference/config-settings/fingerprint"},{"title":"Verbosity","href":"/senseml-reference/config-settings/verbosity"}]},{"group":"Document type settings","pages":[{"title":"Document type settings","sidebarTitle":"Overview","href":"/senseml-reference/document-type-settings/index-document-type-settings"},{"title":"Fingerprint mode","href":"/senseml-reference/document-type-settings/fingerprint-mode"},{"title":"OCR engine","href":"/senseml-reference/document-type-settings/ocr-engine"},{"title":"OCR level","href":"/senseml-reference/document-type-settings/ocr-level"}]},{"group":"Advanced computed field methods","pages":[{"title":"Advanced computed field methods","sidebarTitle":"Overview","href":"/senseml-reference/advanced-computed-field-methods/index-advanced-computed-field-methods"},{"title":"Add computed fields","href":"/senseml-reference/advanced-computed-field-methods/add-computed-fields"},{"title":"Copy from sections","href":"/senseml-reference/advanced-computed-field-methods/copy-from-sections"},{"title":"Copy to section","href":"/senseml-reference/advanced-computed-field-methods/copy-to-section"},{"title":"Custom computation","href":"/senseml-reference/advanced-computed-field-methods/custom-computation"},{"title":"Get file metadata","href":"/senseml-reference/advanced-computed-field-methods/get-file-metadata"}]},{"group":"Concepts","pages":[{"title":"Concepts","sidebarTitle":"Overview","href":"/senseml-reference/concepts/index-concepts"},{"title":"Accuracy measures","href":"/senseml-reference/concepts/accuracy-measures"},{"title":"Anchor nuances","href":"/senseml-reference/concepts/anchor-nuances"},{"title":"Bag of words","href":"/senseml-reference/concepts/bag-of-words"},{"title":"Extraction coverage","href":"/senseml-reference/concepts/coverage"},{"title":"Supported file types","href":"/senseml-reference/concepts/file-types"},{"title":"Field extraction order","href":"/senseml-reference/concepts/field-order"},{"title":"Ligatures","href":"/senseml-reference/concepts/ligatures"},{"title":"Lines","href":"/senseml-reference/concepts/lines"},{"title":"Match arrays","href":"/senseml-reference/concepts/match-arrays"},{"title":"Section nuances","href":"/senseml-reference/concepts/section-nuances"},{"title":"OCR","href":"/senseml-reference/concepts/ocr"},{"title":"SenseML","href":"/senseml-reference/concepts/senseml"},{"title":"Choosing a Table method","href":"/senseml-reference/concepts/table-methods"}]}]},{"group":"API","pages":[{"group":"API Tutorial","pages":[{"title":"API tutorial","sidebarTitle":"Overview","href":"/api-guides/api-tutorial/index-api-tutorial"},{"title":"Try synchronous extraction","href":"/api-guides/api-tutorial/api-tutorial-sync"},{"title":"Try asynchronous extraction from your URL","href":"/api-guides/api-tutorial/api-tutorial-async-1"},{"title":"Try asynchronous extraction from a Sensible URL","href":"/api-guides/api-tutorial/api-tutorial-async-2"},{"title":"Try a webhook","href":"/api-guides/api-tutorial/api-tutorial-webhook"}]},{"title":"Code examples","href":"/api-guides/examples"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/choosing-an-endpoint"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/june-2024"}]}]},"basePath":"","title":"Ligature - Sensible","buildId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","deploymentId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","dynamics":[],"chunks":[]}