namespace Microsoft.Localization.Xliff.Samples { using System;

Size: px

Start display at page:

Download "namespace Microsoft.Localization.Xliff.Samples { using System;"

Nigel Harrell
5 years ago
Views:

//----------------------------------------------------------------------- //

cs" company="microsoft Corporation"> // All rights reserved.

4 using Microsoft.Localization.Xliff.Exceptions; using Microsoft.Localization.Xliff.Extensibility; using Microsoft.Localization.Xliff.Modules.Glossary; using Microsoft.Localization.Xliff.Modules.Metadata; using Microsoft.Localization.Xliff.Modules.TranslationCandidates; using Microsoft.Localization.Xliff.Serialization; using Microsoft.Localization.Xliff.Transforms; using IO = System.IO; public class SampleCode { public static void Main() { Encoder encoder; File file; Group group; Ignorable ignorable; Segment segment; MarkedSpan span; Unit unit; Note note; Match match; Meta meta; MetaGroup metagroup; XliffDocument document; TestExtension extension; IExtensible extensible; GlossaryEntry entry; Translation translation; // Create an xliff document document = new XliffDocument("en-us"); document.targetlanguage = "de-de"; // Read a file from disk string FileName = "C:\\demo\\files\\sample.xml.xlf"; IO.FileStream stream = new IO.FileStream(FileName, IO.FileMode.Open, IO.FileAccess.Read); { XliffReader reader; } reader = new XliffReader(); document = reader.deserialize(stream); // Create a new unit unit = new Unit("u2"); unit.name = "paragraph-1"; unit.type = "cms:text"; unit.translate = true; unit.canresegment = true; // Add a note to the unit note = unit.addnote("this is a unit note"); note.appliesto = TranslationSubject.Source; note.category = "instruction"; note.priority = 1;

5 // Create a new ignorable and add it to the unit ignorable = new Ignorable("i1"); ignorable.source = new Source(" "); unit.resources.add(ignorable); // Create a new segment with a source and target segment = new Segment("s1"); segment.state = TranslationState.Translated; segment.substate = "msft:forreview"; segment.source = new Source(); segment.source.text.add(new PlainText("Press the ")); segment.target = new Target(); segment.target.text.add(new PlainText("Drücken Sie die ")); // Create a new source annotation span = new MarkedSpan("m1"); span.type = "term"; span.text.add(new PlainText("TAB key")); segment.source.text.add(span); // Create a new target annotation span = new MarkedSpan("m1"); span.type = "term"; span.text.add(new PlainText("TAB-TASTE")); segment.target.text.add(span); // Add the segement to the unit unit.resources.add(segment); // Create another segment with an empty source and target segment = new Segment("s2"); segment.state = TranslationState.Translated; segment.substate = "msft:forreview"; segment.source = new Source(); segment.target = new Target(); // Add some encoded text to the source and target encoder = new Encoder(unit); encoder.encode(segment.source, "Goodbye <b>world</b>."); encoder.encode(segment.target, "Tschau <b>welt</b>."); // Add the segement to the unit unit.resources.add(segment); // Add metadata to the unit unit.metadata = new MetadataContainer(); metagroup = new MetaGroup(); metagroup.appliesto = MetaGroupSubject.Source; metagroup.category = "Properties"; metagroup.id = "mg1"; unit.metadata.groups.add(metagroup); meta = new Meta("value"); meta.type = "key"; metagroup.containers.add(meta); // Add matches to the unit match = new Match("#s1");

6 match.id = "m1"; match.matchquality = 90.0f; match.matchsuitability = 90.0f; match.origin = "Autotranslation service"; match.similarity = 90.0f; match.source = new Source("Hello World"); match.subtype = "msft:exact"; match.target = new Target("Hallo Welt"); match.type = MatchType.TranslationMemory; unit.matches.add(match); // Add glossary items to the unit unit.glossary = new Glossary(); entry = new GlossaryEntry(); entry.reference = "#m1"; entry.term.source = "publictermbase"; entry.term.text = "TAB key"; entry.definition = new Definition(); entry.definition.source = "publictermbase"; entry.definition.text = "A keyboard key that is traditionally used to insert tab characters into a document."; unit.glossary.entries.add(entry); translation = new Translation("1"); translation.source = "mytermbase"; translation.text = "Tabstopptaste"; entry.translations.add(translation); translation = new Translation("2"); translation.reference = "#m1"; translation.source = "mytermbase"; translation.text = "TAB-TASTE"; entry.translations.add(translation); // Create a group group = new Group("g1"); group.name = "page-1"; group.type = "cms:text"; group.containers.add(unit); // Add a group note note = group.addnote("this is a group note"); note.appliesto = TranslationSubject.Target; note.category = "comment"; note.priority = 2; // Create a file and add the group file = new File("f2"); file.original = "sample.xml"; file.containers.add(group); // Add a note to the file note = file.addnote("this is a file note"); note.appliesto = TranslationSubject.Target; note.category = "comment"; note.priority = 3; // Add file to the document document.files.add(file);

7 "value1")); "value2")); // Create some custom attributes using the TestExtension extension const string customnamespace = "urn:custom:extension:1.0"; extension = new TestExtension(); extensible = document.files[1]; if (extensible.supportsattributeextensions) { extension.addattribute(new TestAttribute(customNamespace, "custom1", } extension.addattribute(new TestAttribute(customNamespace, "custom2", extensible.extensions.add(extension); // Finally, write out the file string OutputFile = "C:\\demo\\files\\sample.de-de.xml.xlf"; IO.FileStream stream2 = new IO.FileStream(OutputFile, IO.FileMode.Create, IO.FileAccess.Write); { XliffWriter writer; XliffWriterSettings writersettings; writersettings = new XliffWriterSettings(); writersettings.detail = OutputDetail.Explicit; writersettings.indent = true; } } } } writer = new XliffWriter(writerSettings); writer.serialize(stream2, document);

9 <xliff xmlns='urn:oasis:names:tc:xliff:document:2.0' xmlns:gls='urn:oasis:names:tc:xliff:glossary:2.0' xmlns:mtc='urn:oasis:names:tc:xliff:matches:2.0' xmlns:mda='urn:oasis:names:tc:xliff:metadata:2.0' xmlns:msft='microsoft.com' version='2.0' srclang='en-us' trglang='de-de'> <file id='f1'>

10 <unit id="u1" name="paragraph-1" translate="yes" type="cms:text"> <gls:glossary> <gls:glossentry id="g1"> <gls:term>process</gls:term> <gls:translation id="t1">prozess</gls:translation> <gls:translation id="t2">vorgang</gls:translation> <mda:metadata> <mda:metagroup category="term Studio source terminology >  <mda:meta type="resource-id">#/f=f1/u=u1/s1</mda:meta> <mda:meta type="concept-id">15910</mda:meta> <mda:metagroup category="term Studio target terminology >  <mda:meta type="translation-id">t1</mda:meta> <mda:meta type="target-term-id">53093</mda:meta> </mda:metagroup> <mda:metagroup category="term Studio target terminology >  <mda:meta type="translation-id">t2</mda:meta> <mda:meta type="target-term-id">759491</mda:meta> </mda:metagroup> </mda:metagroup> </mda:metadata> </gls:glossentry> </gls:glossary> <mda:metadata> <mda:metagroup category="reach properties"> <mda:meta type="tu-id"> </mda:meta>

11 <mda:meta type="resource-id">#/f=f1/u=u1/s1</mda:meta> </mda:metagroup> <mda:metagroup category="reach properties"> <mda:meta type="tu-id"> </mda:meta> <mda:meta type="resource-id">#/f=f1/u=u1/s2</mda:meta> </mda:metagroup> </mda:metadata> <mtc:matches>  <mtc:match origin="reach Autotranslation Service reference="no" ref="#s1" type="tm" subtype="reach:exact" similarity="100" matchquality="85"> <source>the process has failed.</source> <target>der Prozess ist fehlgeschlagen.</target> </mtc:match>  <mtc:match origin="reach Autotranslation Service reference="no" ref="#s1" type="tm" subtype="reach:exact" similarity="100" matchquality="80"> <source>the process has failed.</source> <target>der Vorgang ist fehlgeschlagen.</target> </mtc:match> </mtc:matches> <notes>  <note category="instruction" id="n1" msft:resource-id="#/f=f1/u=u1/s1">please use modern voice when translating this.</note> <note category="remark" id="n2" msft:resource-id="#/f=f1/u=u1/s1">please do not translate process as Vorgang.</note>  <note category="remark" id="n3" msft:resource-id="#/f=f1/u=u1/s1">hello World is a typical greeting.</note>

12 </notes>  <segment state="translated" substate="msft:auto" id="s1"> <source>what you need to know: The process has failed.</source> <target>was Sie wissen müssen: Der Prozess ist fehlgeschlagen.</target> </segment>  <segment state="translated" substate="reach:forreview" id="s2"> <source>hello World.</source> <target>hallo Welt.</target> </segment> </unit> </file> </xliff>

JLIFF: Where we are, where we're going. Chase Tingley Spartan Software, Inc

JLIFF: Where we are, where we're going Chase Tingley Spartan Software, Inc The Story So Far https://www.flickr.com/photos/anirvan/12002658/ XLIFF has always been XML-based No abstraction independent of