Docusaurus වෙබ් අඩවියක් ඉංග්රීසි අමතරව වෙනත් භාෂා වලින් පවත්වාගෙන යනවානම්, පරිවර්තනයේ ගුණාත්මකභාවය වඩාත් වැදගත් නොවේ; ප්රධාන ගැටලුව එම පරිවර්තන නවීකරණය සමඟ සම්බන්ධයි. එක්වරක් ඉංග්රීසි ලිපියක වාක්ය තුනක් වෙනස් කරද්දී, මාස කිහිපයක් පසු චීන හෝ ස්පැනිශ් සංස්කරණය පරණවීමෙන් පසු පරිශීලකයෙක් ගැටළුවක් වාර්තා කරන තුරු කවුරුත් නොදැන ගනී.
මෙවැනි ගැටලුවට තිරසාර විසඳුම් සොයාගැනීමට, ලේඛකයා තුන් ප්රධාන ක්රම අධ්යයනය කළා – අතින් කළමනාකරණය, Crowdin වැනි පරිවර්තන කළමනාකරණ වේදිකාව, සහ CI (Continuous Integration) පදනමක Diff‑based පරිවර්තනය. පහතදී ඒවා සාරාංශ කරමු.
1. අතින් පරිවර්තන යාවත්කාලීන කිරීම
කොච්චර කුඩා ලේඛන අඩවියක් වුවත්, බොහෝ විටම පරිවර්තකයෝ PR (Pull Request) නිරීක්ෂණය කර, වෙනත් භාෂා ෆෝල්ඩර වලට අතින් යාවත්කාලීන කරනවා. මෙය සුළු සංඛ්යාවක ලේඛන සහ එකම පරිවර්තකයෙක් සමඟ වැඩ කරන විට හොඳට ක්රියා කරයි. නමුත් 50‑100 පිටු ඉක්මවා ගිය විට, වෙනස්කම් සොයාගැනීම අධික කාර්යබහුලයක් බවට පත්වේ. වෙනස්කම් පෙනෙන්නේ පරිශීලකයාට පමණක්, ඒකාලීන අනතුරු ඇඟවීමක් නොලැබෙයි.
2. Crowdin, Lokalise වැනි පරිවර්තන කළමනාකරණ වේදිකාව
මෙම සේවාවන් වචන ගොඩක් අස්සේ ඉවත් කිරීම, පරිවර්තක කණ්ඩායම් සඳහා UI, ඉන්-කොන්ටෙක්ස්ට් සංස්කරණය වැනි විශේෂාංග සපයයි. ඔබට වෘත්තීය පරිවර්තකයන් හෝ ස්ථානීය භාෂා කණ්ඩායමක් තිබේ නම්, මෙය සුදුසු. නමුත් තාක්ෂණික ලේඛන, කේත උදාහරණ, API විස්තර වැනි දේ සඳහා, මෙවැනි සංකීර්ණ සැකසුම වැඩි වියදමක් සහ කාලයක් ගත කරයි. මෙහි ප්රධාන වාසිය වන්නේ පරිවර්තන ගුණාත්මකභාවය ඉහළින් තබා, YAML හෝ Git යන තාක්ෂණික ගොනු වලට අමුත්තන්ට පිවිසීම අවශ්ය නොවේ.
3. CI‑මත Diff‑based පරිවර්තන (GitHub Action)
මෙම ක්රමය GitDocs Sync වැනි GitHub Action එකක් භාවිතා කරයි. ක්රියාකාරිත්වය මෙසේය:
- docs/ ෆෝල්ඩරයේ වෙනස්කම් පසුපස push සිදුවන විට Action එක ක්රියාත්මක වේ.
- අලුත් Markdown/MDX ගොනු සමඟ පසුගිය පරිවර්තනය අතර Diff ගණනය කර, වෙනස් වූ පරාග්රාෆ් පමණක් පරිවර්තනය කරයි.
- කේත කොටස්, front‑matter, HTML ටැග් වැනි අංග වෙනස් නොකෙරේ; කෙලවරේ පමණක් AI API වෙත යැවෙයි.
- පරිවර්තනය කරන ලද අන්තර්ගතය සාමාන්ය PR එකක් ලෙස අරඹයි, ඒ නිසා සමාන්ය code review ක්රියාවලියෙන් පසු ඒක එකතු කළ හැක.
- සමීපතම පරිවර්තන මතකයක් (translation memory) භාවිතා කර, එකම වාක්යය නැවත API කැඳවීමෙන් වැළකිණි.
අමතරව dry‑run මාදිලියක් ඇත, එය පරිවර්තන අවශ්යතා පරීක්ෂා කර, වියදම වැය නොකර "stale" පිටු වාර්තා කරයි.
ශ්රී ලංකාවට ඇති වැදගත්කම
ශ්රී ලංකාවේ තාක්ෂණික ශිෂ්යයන්, සොෆ්ට්වේයාර් ඉංජිනේරුන්, සහ ස්ථානීය ව්යාපාරිකයන්ට මෙම ක්රම තුනේ කිසිවක් භාවිතා කිරීමෙන් ලාභ වේ. අතින් පරිවර්තන කළමනාකරණය සීමිත සම්පත් සහිත ස්ට්රාට්-අප් කණ්ඩායම් සඳහා ඉක්මන් විසඳුමක්. Crowdin වැනි වේදිකාවන් අන්තර්ජාතික ගනුදෙනු, නීතිමය ලේඛන හෝ වෙළෙඳ පණිවුඩ සඳහා ගුණාත්මක පරිවර්තනයේ අවශ්යතාව ඇති ව්යාපාරිකයන්ට සුදුසු. CI‑මත Diff‑based ක්රමය, GitHub හෝ GitLab භාවිතා කරන ඕපන්‑සෝස් ප්රොජෙක්ට්, සමාජීය දායකත්වය සහ ස්වයංක්රීය පරිවර්තන වැය අඩු කර ගැනීමට කැමති සංවිධාන සඳහා ඉතා ප්රයෝජනවත්. මේ සියල්ල එකට ගෙන, ශ්රී ලංකාවේ තාක්ෂණික දැනුම ගෝලීය මට්ටමින් තරගකාරී කර ගැනීමට, ද්රව්යමය කාලය හා පිරිවැය අඩු කර, දේශීය කණ්ඩායම්වලට ඉක්මනින් නවීන ලේඛන වෙත ප්රවේශය ලබා දේ.
අවසන් වශයෙන්, ඔබේ Docusaurus සයිට් එකේ බහුභාෂා අඩවියක් පවත්වාගෙන යන්න, ඔබේ කණ්ඩායමට සහ ව්යාපාරයට සුදුසු ක්රමයක් තෝරාගන්න. තෝරාගත් ක්රමය කුමක් වුවත්, පරිවර්තන සමකාලීන කිරීමේ වැරදි අඩු කර, පරිශීලක අත්දැකීම උසස් කරයි.
