பெயர்

    use Locale::Po4a::Po;
    my $pofile=Locale::Po4a::Po->new();
    # Read PO file
    $pofile->read('file.po');
    # Add an entry
    $pofile->push('msgid' => 'Hello', 'msgstr' => 'bonjour',
                  'flags' => "wrap", 'reference'=>'file.c:46');
    # Extract a translation
    $pofile->gettext("Hello"); # returns 'bonjour'
    # Write back to a file
    $pofile->write('otherfile.po');

மொழி :: po4a :: po என்பது செய்தி பட்டியல்களைக் கையாள உங்களை அனுமதிக்கும் ஒரு தொகுதி. நீங்கள் ஒரு கோப்பிலிருந்து/எழுதலாம்/எழுதலாம் (எந்த நீட்டிப்பு பெரும்பாலும் நான் <po>), நீங்கள் பறக்கும்போது புதிய உள்ளீடுகளை உருவாக்கலாம் அல்லது ஒரு சரத்தின் மொழிபெயர்ப்பைக் கோரலாம்.

PO வடிவத்தில் உள்ள செய்தி பட்டியல்கள் மற்றும் அவற்றின் பயன்பாட்டில் உள்ள முழுமையான விளக்கத்திற்கு, தயவுசெய்து உரைபெறு நிரலின் செய்தி ஆவணங்களைப் பார்க்கவும் (முனை "` PO கோப்புகள் "').

இந்த தொகுதி PO4A திட்டத்தின் ஒரு பகுதியாகும், இது ஆவணங்கள் (MAN PAGE, செய்தி MANUAL), தொகுப்பு விளக்கம், டெப்கான்ஃப் வார்ப்புருக்கள் உள்ளிட்ட அனைத்தையும் மொழிபெயர்க்க PO கோப்புகளை (நிரல் செய்திகளின் மொழிபெயர்ப்பை எளிதாக்குவதற்காக வடிவமைக்கப்பட்டுள்ளது) பயன்படுத்துவதே இதன் நோக்கம் இதன் மூலம் பயனடையலாம்.

B <-porefs> i <type>

குறிப்பு வடிவமைப்பைக் குறிப்பிடவும். உரையாடல் நான் <வகை> எந்தவொரு குறிப்பையும் தயாரிக்காத b <eney> இல் ஒன்றாகும், பி <கோப்பு> வரி எண் இல்லாமல் கோப்பை மட்டுமே குறிப்பிட, பி <கவுண்டர்> வரி எண்ணை அதிகரித்து வரும் கவுண்டரால் மாற்றவும், மற்றும் பி <முழு > முழுமையான குறிப்புகளைச் சேர்க்க (இயல்புநிலை: முழு).

பி <-மடக்கு-போ> பி <இல்லை> | பி <புதிய லைன்ச்> | நான் <எண்> (இயல்புநிலை: 76)

PO கோப்பை எவ்வாறு மூட வேண்டும் என்பதைக் குறிப்பிடவும். இது நன்றாக மூடப்பட்டிருக்கும், ஆனால் அறிவிலி மோதல்களுக்கு வழிவகுக்கும் அல்லது தானாகவே கையாள எளிதான கோப்புகளுக்கு இடையேயான தேர்வை அளிக்கிறது, ஆனால் மனிதர்களுக்காக படிக்க கடினமாக உள்ளது.

வரலாற்று ரீதியாக, கெட்டெக்ச்ட் தொகுப்பு அழகுசாதனப் பொருட்களுக்காக 77 வது நெடுவரிசையில் PO கோப்புகளை மறுவடிவமைத்துள்ளது. இந்த விருப்பம் PO4A இன் நடத்தையைக் குறிப்பிடுகிறது. ஒரு எண் மதிப்புக்கு அமைக்கப்பட்டால், PO4A இந்த நெடுவரிசைக்குப் பிறகு மற்றும் உள்ளடக்கத்தில் புதிய லைன்களுக்குப் பிறகு PO கோப்பை மூடிவிடும். பி <புதிய லைன்ச்> என அமைக்கப்பட்டால், PO4A உள்ளடக்கத்தில் புதிய லைன்களுக்குப் பிறகு MSGID மற்றும் MSGSTR ஐ மட்டுமே பிரிக்கும். பி <இல்லை> என அமைக்கப்பட்டால், PO4A PO கோப்பை மூடாது. குறிப்பு கருத்துகள் எப்போதும் நாங்கள் உள்நாட்டில் பயன்படுத்தும் கெட்டெக்ச்ட் கருவிகளால் மூடப்பட்டிருக்கும்.

MSGID மற்றும் MSGSTR எவ்வாறு மூடப்பட்டிருக்கும் என்பதில் இந்த விருப்பம் எந்த தாக்கத்தையும் ஏற்படுத்தாது என்பதை நினைவில் கொள்க, அதாவது இந்த சரங்களின் உள்ளடக்கத்தில் புதியவை எவ்வாறு சேர்க்கப்படுகின்றன என்பதில்.

B <-msgid-bugs-address> i <மின்னஞ்சல்@முகவரி>

எம்.எச்.சி.ஐ.டி பிழைகளுக்கான அறிக்கை முகவரியை அமைக்கவும். இயல்பாக, உருவாக்கப்பட்ட பானை கோப்புகளுக்கு அறிக்கை இல்லை-MSGID-BUGS-TO புலங்கள் இல்லை.

பி <-பதிப்புரிமை-ஓல்டர்> நான் <string>

பதிப்புரிமை வைத்திருப்பவரை பானை தலைப்பில் அமைக்கவும். இயல்புநிலை மதிப்பு "இலவச மென்பொருள் அறக்கட்டளை, இன்க்."

பி <-தொகுப்பு-பெயர்> நான் <string>

பானை தலைப்புக்கு தொகுப்பு பெயரை அமைக்கவும். இயல்புநிலை "தொகுப்பு".

பி <-தொகுப்பு-பதிப்பு> நான் <string>

பானை தலைப்புக்கு தொகுப்பு பதிப்பை அமைக்கவும். இயல்புநிலை "பதிப்பு".

புதிய ()

புதிய செய்தி பட்டியலை உருவாக்குகிறது. ஒரு உரையாடல் வழங்கப்பட்டால், அது நாம் ஏற்ற வேண்டிய PO கோப்பின் பெயர்.

படிக்க ($)

ஒரு PO கோப்பைப் படிக்கிறது (எந்த பெயர் வாதமாக வழங்கப்படுகிறது). முன்னர் சுயத்தில் இருக்கும் உள்ளீடுகள் அகற்றப்படவில்லை, புதியவை பட்டியலின் முடிவில் சேர்க்கப்படுகின்றன.

எழுது ($)

கொடுக்கப்பட்ட கோப்பில் தற்போதைய பட்டியலை எழுதுகிறார்.

write_if_needed ($$)

எழுதுவது போல, ஆனால் PO அல்லது POT கோப்பு ஏற்கனவே இருந்தால், பொருள் ஒரு தற்காலிக கோப்பில் எழுதப்படும், இது புதுப்பிப்பு தேவையா என்பதை சரிபார்க்க தற்போதுள்ள கோப்போடு ஒப்பிடப்படும் (இது ஒரு வரி குறிப்பைப் புதுப்பிக்க ஒரு பானையை மாற்றுவதைத் தவிர்க்கிறது அல்லது பானை உருவாக்கும் தேதி புலம்).

வடிகட்டி ($)

இந்த செயல்பாடு ஏற்கனவே உள்ள ஒன்றிலிருந்து ஒரு பட்டியலைப் பிரித்தெடுக்கிறது. கொடுக்கப்பட்ட கோப்பில் குறிப்பு கொண்ட உள்ளீடுகள் மட்டுமே இதன் விளைவாக வரும் பட்டியலில் வைக்கப்படும்.

இந்த செயல்பாடு அதன் வாதத்தை பாகுபடுத்துகிறது, அதை ஒரு பெர்ல் செயல்பாட்டு வரையறையாக மாற்றுகிறது, இந்த வரையறையை வெளிப்படுத்துகிறது மற்றும் இந்த செயல்பாடு உண்மையாக வரும் புலங்களை வடிகட்டுகிறது.

நான் சில நேரங்களில் பெர்லை நேசிக்கிறேன்;)

உரைபெறு ($%)

தற்போதைய பட்டியலில் வாதமாக கொடுக்கப்பட்ட சரத்தின் மொழிபெயர்ப்பைக் கோருங்கள். சரம் காணப்படாவிட்டால் செயல்பாடு அசல் (மொழிபெயர்க்கப்படாத) சரத்தை வழங்குகிறது.

மொழிபெயர்க்க சரம் பிறகு, கூடுதல் வாதங்களின் ஆசை நீங்கள் அனுப்பலாம். சரியான உள்ளீடுகள் இங்கே:

புள்ளிவிவரங்கள்_செட் ()

புள்ளிவிவரங்கள்_கலியர் () அழைக்கப்பட்ட கடைசி நேரத்திலிருந்து கெட்டெக்ச்டின் செய் விகிதம் குறித்த புள்ளிவிவரங்களை வழங்குகிறது. MSGFMT -ச்டாடிச்டிக் அச்சிட்டதை விட இது அதே புள்ளிவிவரங்கள் அல்ல என்பதை நினைவில் கொள்க. இங்கே, இது PO கோப்பின் அண்மைக் கால பயன்பாடு பற்றிய புள்ளிவிவரங்கள், அதே நேரத்தில் MSGFMT கோப்பின் நிலையைப் புகாரளிக்கிறது. பயன்பாட்டின் எடுத்துக்காட்டு:

    [some use of the PO file to translate stuff]
    ($percent,$hit,$queries) = $pofile->stats_get();
    print "So far, we found translations for $percent\%  ($hit of $queries) of strings.\n";
    

புள்ளிவிவரங்கள்_ கிளையர் ()

உரைபெறு வெற்றிகளைப் பற்றிய புள்ளிவிவரங்களை அழிக்கிறது.

தள்ளு (%)

தற்போதைய பட்டியலின் முடிவில் புதிய நுழைவை தள்ளுங்கள். வாதங்கள் ஒரு ஆச் அட்டவணையை உருவாக்க வேண்டும். செல்லுபடியாகும் விசைகள்:

count_entries ()

பட்டியலில் உள்ள உள்ளீடுகளின் எண்ணிக்கையை வழங்குகிறது (தலைப்பு இல்லாமல்).

count_entries_doc ()

ஆவணத்தில் உள்ளீடுகளின் எண்ணிக்கையை வழங்குகிறது. ஆவணத்தில் ஒரு சரம் பல முறை தோன்றினால், அது பல முறை கணக்கிடப்படும்.

msgid ($)

கொடுக்கப்பட்ட எண்ணின் MSGID ஐ வழங்குகிறது.

msgid_doc ($)

ஆவணத்தில் கொடுக்கப்பட்ட நிலையுடன் MSGID ஐ வழங்குகிறது.

type_doc ($)

ஆவணத்தில் கொடுக்கப்பட்ட நிலையுடன் MSGID இன் வகையை வழங்குகிறது. இது GetTextization க்கு மட்டுமே பயனுள்ளதாக இருக்கும், மேலும் இது {$ msgid} {'type' இருந்து இலிருந்து தனித்தனியாக சேமிக்கப்படுகிறது, ஏனெனில் முதன்மை ஆவணத்தில் $ msgid நகல் செய்யப்படும்போது பிற்கால இடம் மற்றொரு வகையால் மேலெழுதப்படலாம்.

get_charset ()

PO தலைப்பில் குறிப்பிடப்பட்டுள்ள எழுத்துத் தொகுப்பை வழங்குகிறது. அது அமைக்கப்படவில்லை என்றால், அது "யுடிஎஃப் -8" திரும்பும்.

 Denis Barbier <barbier@linuxfr.org>
 Martin Quinson (mquinson#debian.org)