Title*Sysero Styler User Manual and Quick Start Guide

Detail

Sysero Styler User Manual: Style Mapping Guide

Overview

Sysero Styler is a web application that helps you clean up, standardize, and apply consistent styling to Microsoft Word (.docx) documents using custom templates. The most powerful feature is Style Mapping, which allows you to precisely control how styles from your uploaded document are transformed to match your organization's template styles.

Getting Started

System Requirements

• Modern web browser (Chrome, Firefox, Safari, Edge)

• Internet connection

• Microsoft Word (.docx) or Markdown (.md) files to process

Quick Start

1. Open Sysero Styler in your web browser

2. Upload a document by dragging and dropping or clicking "Select file"

3. Choose a template from the library or upload your own

4. Map document styles to template styles (optional but recommended)

5. Apply cleaning operations and export your styled document

Understanding Style Mapping

What is Style Mapping?

Style mapping is the process of telling Sysero Styler how to transform the styles in your uploaded document to match the styles in your chosen template. Instead of simply applying template styles generally, style mapping gives you precise control over which document styles become which template styles.

Why Use Style Mapping?

Without Style Mapping:

• Template styles are applied broadly to similar-looking content

• Results may not match your exact requirements

• Heading hierarchies might be automatically adjusted

• Your document's specific style intentions may be lost

With Style Mapping:

• You control exactly how each style transforms

• Maintain your document's logical structure

• Ensure consistent branding and formatting

• Preserve author intentions while applying organizational standards

Example Scenario

Your Document Has:

• "Executive Summary" style for important headings

• "Project Title" style for project names

• "Body Text" style for regular paragraphs

Your Template Has:

• "Heading 1" style for main headings

• "Heading 2" style for sub-headings

• "Normal" style for body text

Style Mapping Allows You To:

• Map "Executive Summary" → "Heading 1"

• Map "Project Title" → "Heading 2"

• Map "Body Text" → "Normal"

Step-by-Step Workflow

Step 1: Upload Your Document

1. Access the Upload Screen

• Open Sysero Styler

• You'll see the main upload area with drag-and-drop functionality

1. Upload Your Document

• Option A: Drag and drop your .docx or .md file onto the upload area

• Option B: Click "Select file" and browse to your document

• Option C: Choose from recent documents if available

1. Supported File Types

• Microsoft Word (.docx) files up to 10MB

• Markdown (.md) files (automatically converted to .docx using Pandoc conventions)

?? Markdown File Processing with Pandoc Conventions

When you upload a Markdown file, Sysero Styler applies Pandoc's industry-standard mapping conventions:

Style Mappings:

• Headings: # → "Heading 1", ## → "Heading 2", ### → "Heading 3", etc.

• Paragraphs: Normal text → "Normal" style

• Block Elements: Block quotes → "Block Text", abstracts → "Abstract"

• Code: Inline code → "Verbatim Char", code blocks → "Source Code"

• Lists: Bullets and numbering follow Pandoc's standard formatting

• Emphasis: italic and bold → proper character styles

Why Pandoc Conventions?

• ?? Industry Standard: Pandoc is the gold standard for document conversion

• ?? Consistency: Ensures predictable style mapping across different documents

• ?? Compatibility: Works seamlessly with existing Pandoc workflows

• ? Professional Output: Produces clean, well-structured DOCX files

1. File Processing

• Wait for the document to upload and process

• You'll see a progress indicator during processing

Step 2: Review Document Analysis

1. Automatic Analysis

• Sysero Styler automatically analyzes your document's styles

• View detected styles, formatting issues, and document health score

1. Style Detection

• Review paragraph styles found in your document

• Note any direct formatting or inconsistencies

• Check the style usage statistics

Step 3: Choose and Apply a Template

1. Template Selection Options

• Quick Templates: Use the 6 most recent templates shown on the upload screen

• Template Library: Click "Template Library" for full template management

• Upload New Template: Add a new .docx template to your library

1. Apply Template

• Click "Apply Template" in the Analysis screen

• Select your desired template from the list

• The template's styles will be loaded for potential mapping

Step 4: Map Styles (Core Feature)

This is where the powerful style mapping happens. This step is optional but highly recommended for precise control.

Opening the Style Mapping Interface

1. the Apply Template Modal:

• After selecting a template, click "Map Document Styles to Template"

• Wait for template styles to load (indicated by the button text)

1. Style Mapping Modal Opens:

• Left dropdown: Shows your document's paragraph styles

• Right dropdown: Shows the template's paragraph styles

• Current mappings list: Shows any existing mappings

Creating Style Mappings

1. Select Document Style

• Choose the style from your document that you want to map

• Only styles that aren't already mapped will appear

1. Select Template Style

• Choose the corresponding template style you want it to become

• All template styles are available for selection

1. Add the Mapping

• Click "Add Mapping" to create the relationship

• The mapping appears in the "Current Mappings" list

1. Repeat for All Desired Styles

• Continue mapping document styles to template styles

• You don't need to map every style—only the ones you want to control precisely

Understanding the Mapping Interface

Document Style → Template Style
--------------------------------
"Executive Summary" → "Heading 1"
"Project Title" → "Heading 2"
"Body Text" → "Normal"

Key Points:

• Each document style can only be mapped once

• You can delete mappings if you make a mistake

• Unmapped styles will use default template application logic

Step 5: Save and Apply Mappings

1. Save Mappings

• Click "Save Mappings" to store your style mappings

• Mappings are automatically saved to the template for future use

1. Apply Template with Mappings

• Close the mapping modal

• Click "Apply Template Styles" in the main modal

• Your mappings will be applied along with the template

Step 6: Review and Clean Document

1. Document Processing

• Sysero Styler applies your style mappings first

• Then applies the template's overall styling

• Finally, you can apply additional cleaning operations

1. Choose Cleaning Options

• Normalize headings (respects your style mappings)

• Consolidate fonts

• Fix spacing and lists

• Remove direct formatting

1. Start Cleaning

• Click "Start Cleaning" to process the document

• Style mappings are preserved throughout the cleaning process

Step 7: Preview and Export

1. Preview Changes

• Review the "Before" and "After" versions

• Check that your style mappings were applied correctly

• Verify the overall document appearance

1. Export Options

• Download the cleaned .docx file

• Export a style guide

• Generate a before/after report

Style Mapping in Detail

How Style Mapping Works Technically

1. Style Detection

• Sysero Styler reads the word/styles.xml file from your document

• Identifies all paragraph styles and their properties

• Creates a mapping interface showing available styles

1. Mapping Application

• When you create mappings, they're stored with the template

• During processing, the word/document.xml file is modified

• Each paragraph's style reference is updated according to your mappings

1. Preservation During Cleaning

• Style mappings are protected during the cleaning process

• The normalization functions skip styles that were intentionally mapped

• Your mappings take precedence over automatic style adjustments

Types of Styles You Can Map

Paragraph Styles

• Headings: Heading 1, Heading 2, Heading 3, etc.

• Body Styles: Normal, Body Text, etc.

• Special Styles: Title, Subtitle, Quote, etc.

• Custom Styles: Any custom paragraph styles in your document

What Gets Mapped

• ? Paragraph formatting: Font, size, color, spacing

• ? Text formatting: Bold, italic, underline

• ? Spacing: Before/after paragraph spacing, line spacing

• ? Alignment: Left, center, right, justified

• ? Indentation: Left and right indents, first line indents

What Doesn't Get Mapped

• ? Character styles: These are handled separately

• ? Table styles: Tables have their own style system

• ? List styles: These are handled by list formatting options

• ? Direct formatting: This is removed by the cleaning process

Advanced Mapping Concepts

Default Style Handling

• Paragraphs without explicit style references use the "Normal" or default style

2. you don't map the default style, it will use the template's default

• Consider mapping your document's "Normal" style to the template's "Normal" style

Style Inheritance

• Some styles inherit properties from parent styles

• Mapping preserves these inheritance relationships

• Template styles maintain their inheritance structure

Mapping Validation

• The system prevents duplicate mappings

• You can't map one document style to multiple template styles

• The interface shows which styles are available for mapping

Debugging Style Mappings

3. style mappings aren't working as expected, use the built-in debugging tool:

1. Open Browser Console

• Press F12 (Windows/Linux) or Cmd+Option+I (Mac)

• Navigate to the Console tab

1. Run Debug Command

javascript
debugStyleMappings();

1. Review Debug Information

• Total paragraphs in document

• Paragraphs with/without explicit styles

• Style distribution analysis

• Mapping opportunities and current mappings

Template Management

Creating Effective Templates

1. Template Requirements

• Must be a valid .docx file

• Should contain all the styles you want to use

• Should have consistent, well-named styles

1. Best Practices for Templates

• Use descriptive style names (e.g., "Executive Summary" not "Style1")

• Include all heading levels you typically use

• Define consistent font families and sizes

• Set appropriate spacing and indentation

1. Template Categories

• Organize templates by document type (reports, proposals, letters)

• Use categories to group related templates

• Consider creating department-specific template categories

Managing Style Mappings in Templates

Viewing Saved Mappings

4. Template Manager

• Find your template in the list

• Click the "View/Clear Style Mappings" button (list icon)

• Review all saved mappings for that template

1. Mapping Information Shown

• Document style → Template style relationships

• Number of mappings saved

• Option to clear all mappings

Reusing Mappings

• Mappings are automatically saved to templates

• When you apply the same template again, your mappings are loaded

• This creates consistency across similar documents

Updating Mappings

• Apply the template to a new document

• Modify the mappings as needed

• Save the updated mappings (they overwrite the previous ones)

Template Best Practices

1. Style Naming Conventions

Good Style Names:
    - "Heading 1 - Chapter"
    - "Body Text - Standard"
    - "Quote - Indented"

    Poor Style Names:
    - "Style1"
    - "Custom"
    - "abc"

1. Comprehensive Style Sets

• Include all heading levels (1-6 if needed)

• Define body text variations

• Include special styles (captions, quotes, etc.)

• Consider table and list styles

1. Testing Templates

• Test templates with various document types

• Verify style mappings work as expected

• Check export results for consistency

Advanced Features

Batch Processing Workflows

1. Standardizing Multiple Documents

• Create style mappings for a representative document

• Apply the same template and mappings to similar documents

• Use consistent cleaning options across documents

1. Department-Wide Style Standards

• Create templates for each document type

• Define standard style mappings for common scenarios

• Train users on consistent mapping approaches

Integration with Document Workflows

1. Pre-Publication Processing

• Use Sysero Styler before sending documents to clients

• Apply corporate branding through style mappings

• Ensure consistency across document sets

1. Document Conversion Workflows

• Convert external documents to internal standards

• Map external styles to internal style systems

• Maintain formatting while applying branding

Automated Style Detection

Sysero Styler includes intelligent features to help with style mapping:

1. Similar Style Suggestions

• The system may suggest mappings based on style names

• Similar formatting characteristics are analyzed

• Heading level detection helps with automatic suggestions

1. Mapping Validation

• Warnings for potentially problematic mappings

• Validation of style compatibility

• Checks for mapping completeness

Troubleshooting

Common Style Mapping Issues

Problem: Style Mappings Not Applied

Symptoms:

• Document styles don't change after applying template

• Mappings show as saved but don't appear in final document

Solutions:

1. Check Style References:

• Ensure your document uses paragraph styles, not direct formatting

• Use the debug tool: debugStyleMappings() in browser console

• Look for paragraphs without explicit style references

1. Verify Template Selection:

• Confirm the correct template is selected

• Check that template has the target styles you're mapping to

• Reload template styles if they seem outdated

1. Clear Browser Cache:

• Hard refresh the page (Ctrl+F5 or Cmd+Shift+R)

• Clear browser cache and cookies for the site

• Restart the browser if needed

Problem: First Paragraph Not Mapped Correctly

Symptoms:

• All paragraphs map correctly except the first one

• First paragraph reverts to original style

Solutions:

1. This is a Known Issue:

• Has been addressed in recent updates

• Ensure you're using the latest version

1. Workaround:

• Apply template and mappings

• Check if the issue still occurs

• Report to support if problem persists

Problem: Some Styles Not Available for Mapping

Symptoms:

• Expected document styles don't appear in mapping dropdown

• Template styles missing from selection

Solutions:

1. Document Style Issues:

• Check if styles are actually used in the document

• Verify styles aren't direct formatting instead

• Use the analysis screen to see detected styles

1. Template Style Issues:

• Confirm template file is valid .docx

• Check if template has defined paragraph styles

• Re-upload template if necessary

Performance Issues

Large Document Processing

For documents with many styles or pages:

1. Consider breaking large documents into sections

2. Process during off-peak hours

3. Ensure stable internet connection

4. Allow extra time for processing

Browser Memory Issues

5. the browser becomes slow or unresponsive:

1. Close other browser tabs

2. Restart the browser

3. Try a different browser

4. Clear browser cache

Error Messages

"Template has no paragraph styles to map"

• Cause: Selected template doesn't contain usable paragraph styles

• Solution: Upload a different template or verify template file integrity

"No document paragraph styles available to map"

• Cause: Document uses direct formatting instead of styles

• Solution: Clean document formatting first, or apply styles in Word before upload

"Failed to load template details"

• Cause: Template file corrupted or network issue

• Solution: Re-upload template or check internet connection

Best Practices

Document Preparation

1. Before Upload:

• Use paragraph styles instead of direct formatting in Word

• Give styles descriptive names

• Apply styles consistently throughout the document

• Remove excessive direct formatting

1. Style Naming:

• Use clear, descriptive style names

• Avoid generic names like "Style1" or "Custom"

• Consider including purpose in name (e.g., "Heading - Section")

Template Design

1. Style Organization:

• Create comprehensive style sets

• Use logical naming conventions

• Include all necessary heading levels

• Define consistent formatting

1. Testing:

• Test templates with various document types

• Verify mappings work as expected

• Document standard mappings for team use

Mapping Strategy

1. Plan Your Mappings:

• Review both document and template styles before mapping

• Consider the logical hierarchy of your content

• Map the most important styles first

1. Consistency:

• Use consistent mapping approaches across similar documents

• Document your mapping decisions for team reference

• Create standard operating procedures for common document types

1. Validation:

• Always preview results before exporting

• Check mapping results in different sections of the document

• Verify heading hierarchy is maintained

Quality Control

1. Review Process:

• Always preview before exporting

• Check critical sections of the document

• Verify corporate branding is applied correctly

1. Testing:

• Test new templates with sample documents

• Validate mapping results across different document types

• Get feedback from document users

Team Workflows

1. Training:

• Train team members on consistent mapping approaches

• Document standard templates and mappings

• Create guidelines for common scenarios

1. Templates:

• Centralize template management

• Version control template updates

• Communicate template changes to users

Support and Resources

Getting Help

1. Built-in Help:

• Info icons throughout the interface provide contextual help

• Error messages include troubleshooting suggestions

• Debug tools are available in the browser console

1. Documentation:

• This user manual covers comprehensive usage

• Technical documentation available for developers

• Style mapping fix documentation for technical issues

1. Support Channels:

• Contact your system administrator for technical issues

• Report bugs through appropriate channels

• Request features through proper channels

Additional Resources

1. Microsoft Word Style Reference:

• Understanding paragraph vs. character styles

• Creating and managing styles in Word

• Best practices for document formatting

1. Document Standards:

• Corporate style guidelines

• Department-specific formatting requirements

• Industry standard document formats

Appendix: Technical Details

File Formats Supported

• Input: .docx (Microsoft Word), .md (Markdown)

• Output: .docx (Microsoft Word)

• Templates: .docx (Microsoft Word)

Browser Compatibility

• Recommended: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+

• Minimum: Any modern browser with JavaScript enabled

• Mobile: Limited support, desktop browser recommended

Processing Limitations

• File Size: 10MB maximum per document

• Styles: No limit on number of styles per document

• Mappings: No limit on number of style mappings

• Concurrent Users: Depends on server capacity

Security and Privacy

• File Processing: All processing happens in the browser when possible

• Data Storage: Templates stored locally in browser storage

• Privacy: No document content is transmitted to external servers for core processing

This manual covers Sysero Styler version 2.0+ with advanced style mapping features. For questions or support, contact your system administrator.

Sysero Styler User Manual: Style Mapping Guide

Overview

Table of Contents

Getting Started

System Requirements

Quick Start

Understanding Style Mapping

What is Style Mapping?

Why Use Style Mapping?

Example Scenario

Step-by-Step Workflow

Step 1: Upload Your Document

?? **Markdown File Processing with Pandoc Conventions**

Step 2: Review Document Analysis

Step 3: Choose and Apply a Template

Step 4: Map Styles (Core Feature)

Opening the Style Mapping Interface

Creating Style Mappings

Understanding the Mapping Interface

Step 5: Save and Apply Mappings

Step 6: Review and Clean Document

Step 7: Preview and Export

Style Mapping in Detail

How Style Mapping Works Technically

Types of Styles You Can Map

Paragraph Styles

What Gets Mapped

What Doesn't Get Mapped

Advanced Mapping Concepts

Default Style Handling

Style Inheritance

Mapping Validation

Debugging Style Mappings

Template Management

Creating Effective Templates

Managing Style Mappings in Templates

Viewing Saved Mappings

Reusing Mappings

Updating Mappings

Template Best Practices

Advanced Features

Batch Processing Workflows

Integration with Document Workflows

Automated Style Detection

Troubleshooting

Common Style Mapping Issues

Problem: Style Mappings Not Applied

Problem: First Paragraph Not Mapped Correctly

Problem: Some Styles Not Available for Mapping

Performance Issues

Large Document Processing

Browser Memory Issues

Error Messages

"Template has no paragraph styles to map"

"No document paragraph styles available to map"

"Failed to load template details"

Best Practices

Document Preparation

Template Design

Mapping Strategy

Quality Control

Team Workflows

Support and Resources

Getting Help

Additional Resources

Appendix: Technical Details

File Formats Supported

Browser Compatibility

Processing Limitations

Security and Privacy

?? Markdown File Processing with Pandoc Conventions