তাহলে কেন আমার মতো বহুবর্ষজীবী নবীন / হ্যাকার / ডিআইআইআরগুলিকে বিভ্রান্ত করার জন্য এপিআই ডকুমেন্টেশন এমনভাবে লেখা হয়?
এটি আসলে সেভাবে লেখা উচিত নয়। আমি সম্মত হব এপিআই নথি জুড়ে ব্যবহারের কোনও সহজতা নেই বলে মনে হচ্ছে। তবে, পুরানো manস্টাইল সিনট্যাক্স কনভেনশন থেকে আধুনিক এপিআই / নেমস্পেস কনভেনশনগুলিতে প্রচুর ক্রস ওভার রয়েছে ।
সাধারণত, যে ধরণের ব্যক্তি এপিআই দিয়ে কাজ করে সেগুলির বিকাশের কিছুটা ব্যাকগ্রাউন্ড বা কমপক্ষে একটি 'পাওয়ার ব্যবহারকারী' থাকবে। এই ধরণের ব্যবহারকারীরা এ জাতীয় সিনট্যাক্স কনভেনশনগুলিতে ব্যবহৃত হয় এবং এপিআই ডকুমেন্টটি নতুন তৈরির চেষ্টা করার চেয়ে অনুসরণ করা আরও বেশি অর্থবোধ করে।
কোথাও এমন কিছু রহস্যজনক দলিল আছে যা মানুষকে এপিআই ডকুমেন্টেশন কীভাবে পড়তে হয় তা বলে?
সত্যিই কোথাও আশেপাশে কোনও স্ট্যান্ডার্ড, বা আরএফসি নেই, সুপারসেক্রেটসিন্ট্যাক্সডোক রয়েছে, তবে ইউনিক্স ম্যান পেজ সিঙ্কপোসিস ফর্ম্যাটের জন্য ~ 30 বছরের পুরানো ফাইল রয়েছে যা ব্যাপকভাবে ব্যবহৃত হয়।
এর কয়েকটি উদাহরণ (এবং আপনার প্রশ্নের উত্তর দেওয়া):
আন্ডারলাইন করা শব্দগুলিকে আক্ষরিক বিবেচনা করা হয়, এবং টাইপ করা হয় ঠিক যেমনটি প্রদর্শিত হয়।
একটি আর্গুমেন্টের চারপাশে স্কোয়ার বন্ধনী ([]) নির্দেশ করে যে আর্গুমেন্টটি alচ্ছিক।
উপবৃত্তাকার ... পূর্ববর্তী যুক্তি-প্রোটোটাইপ পুনরাবৃত্তি হতে পারে তা দেখানোর জন্য ব্যবহৃত হয়।
একটি বিয়োগ চিহ্ন দিয়ে শুরু হওয়া একটি যুক্তি - প্রায়শই কোনও ধরণের পতাকা যুক্তি বোঝাতে নেওয়া হয় এমনকি যদি এটি এমন কোনও অবস্থানে উপস্থিত হয় যেখানে কোনও ফাইলের নাম উপস্থিত হতে পারে।
প্রায় সমস্ত প্রোগ্রামিং সম্পর্কিত ডকুমেন্টেশন এ ধরণের সিনট্যাক্স কনভেনশন ব্যবহার করে পাইথন , ম্যান পেজ , জাভাস্ক্রিপ্ট লিবস ( হাইচার্ট ) ইত্যাদি,
অ্যাডোব এপিআই থেকে আপনার উদাহরণটি ভাঙা
fillPath
([fillColor]
[, mode]
[, opacity]
[, preserveTransparency] [, feather]
[, wholePath] [, antiAlias])
আমরা দেখতে পাচ্ছি fillPath()(একটি ফাংশন) alচ্ছিক আর্গুমেন্ট গ্রহণ করে fillColor, mode, opacity, preserveTransparency, feathe, wholePathবা antiAlias। কল করা হচ্ছে fillPath(), আপনি যে প্যারামিটারগুলির মধ্যে এটির থেকে যে কোনও জায়গায় যে কোনও জায়গায় যেতে পারেন। Alচ্ছিক কমাগুলির []অর্থ হ'ল যদি এই প্যারামিটারটি অন্যদের পাশাপাশি ব্যবহৃত হয় তবে এটির আলাদা করতে আপনার কমা প্রয়োজন। (সাধারণ জ্ঞান কখনও কখনও, অবশ্যই, তবে কখনও কখনও ভিবি এর মতো কিছু ভাষার স্পষ্টতই সেই কমাগুলি প্রয়োজন যা সঠিকভাবে কোন প্যারামিটারটি অনুপস্থিত রয়েছে তা বর্ণনা করতে পারে!)। যেহেতু আপনি ডকুমেন্টেশনের সাথে লিঙ্ক করেননি (এবং আমি এটি অ্যাডোবের স্ক্রিপ্টিং পৃষ্ঠায় খুঁজে পাচ্ছি না ) অ্যাডোব এপিআই কোন ফর্ম্যাটের প্রত্যাশা করছে তা জানার উপায় নেই। যাইহোক, বেশিরভাগ ডকুমেন্টেশনের শীর্ষে একটি কনভেনশনগুলির মধ্যে ব্যবহৃত ব্যাখ্যাগুলির শীর্ষে থাকতে হবে expla
সুতরাং, এই ফাংশনটি সম্ভবত বিভিন্ন উপায়ে ব্যবহার করা যেতে পারে:
fillPath() //Nothing passed
fillPath(#000000,RGB) // Black, in RGB mode
fillPath(#000000,RGB,50) // Black, in RGB mode, half opacity
//Now it gets tricky, this might ALSO be acceptable:
fillPath(#000000,50) // Black, no mode, half opacity
//OR
fillPath(#000000,,50) // Black, no mode, half opacity
আবার, এপিআই / প্রোগ্রামিং সম্পর্কিত সমস্ত নথি জুড়ে সাধারণত কিছু মান রয়েছে standards তবে প্রতিটি নথিতে সূক্ষ্ম পার্থক্য থাকতে পারে। পাওয়ার ব্যবহারকারী বা বিকাশকারী হিসাবে আপনি যে ডকুমেন্টগুলি / ফ্রেমওয়ার্ক / লাইব্রেরিগুলি ব্যবহার করার চেষ্টা করছেন তা আপনি বুঝতে এবং বুঝতে সক্ষম হবেন বলে আশা করা হচ্ছে।