আমরা বর্তমানে AsciiDoc নামক একটি সিস্টেম ব্যবহার করি যা আমাদের একটি সাধারণ পাঠ্য মার্কআপে ডকুমেন্টেশন তৈরি করতে দেয়। এটি থেকে আমরা একাধিক আউটপুট ফর্ম্যাট তৈরি করতে পারি। আমরা কেবল পিডিএফ আউটপুট এবং chm আউটপুট ফর্ম্যাট ব্যবহার করি।
আমি ভাবছিলাম chm এর বিকল্প ছিল কিনা? আমি যা খুঁজছি তা হ'ল এমন একটি যা অফ-লাইন ব্যবহার করা যায় (এটি গুরুত্বপূর্ণ কারণ আমাদের বেশ কয়েকটি ব্যবহারকারী খুব দূরবর্তী স্থানে রয়েছেন) আমাদের সফ্টওয়্যার সহ। এটির একটি সূচক থাকতে হবে (এটি হাইপারলিংকড শর্তাবলী সহ এইচটিএমএল পৃষ্ঠার মতো সহজ হতে পারে), এটি অনুসন্ধানযোগ্য হওয়া উচিত এবং এতে একটি প্রক্রিয়া থাকা উচিত যা কোড থেকে নির্দিষ্ট এন্ট্রিগুলি কল করার অনুমতি দেয় (প্রসঙ্গে সংবেদনশীল সাহায্যের অনুরূপ)।
এই ক্ষেত্রে দুটি জিনিস যা পিডিএফের বিরুদ্ধে রয়েছে তা হ'ল:
- প্রসঙ্গে সংবেদনশীল সহায়তা কোনও বিকল্প নয়
- সাধারণত ডকুমেন্টটি বরং বড় হয়
- পিডিএফ প্রসঙ্গে সংবেদনশীল সাহায্যের চেয়ে মুদ্রিত ডকুমেন্টেশনের পক্ষে বেশি উপযুক্ত
আমি যা চাই তা এইচটিএমএল ব্যবহার করা। এইচটিএমএলটির একমাত্র সমস্যা হ'ল আমি কীভাবে কীওয়ার্ড অনুসন্ধান (ব্রাউজারগুলি সিটিআরএল + এফ কার্যকারিতা ব্যতীত - কীভাবে আরও স্পষ্ট কিছু চাই) সরবরাহ করতে পারি তা বুঝতে পারি না can't মূল শব্দের একটি হাইপার-লিঙ্কড সূচক স্বয়ংক্রিয়ভাবে উত্পন্ন করার জন্য আমি কোনও পদ্ধতি খুঁজে পাচ্ছি না। বিভাগের ট্যাগগুলির কারণে প্রসঙ্গে সংবেদনশীল সহায়তা সহজ হবে - আমি কেবল পৃষ্ঠা এবং বিভাগটির ইউআরএলটি পাস করতে পারি যে আমি ডিফল্ট ব্রাউজারে আগ্রহী এবং সেই পৃষ্ঠাটি সঠিক বিভাগ পর্যন্ত লোড করা উচিত।
আমার প্রয়োজনীয়তাগুলি chm এর মতো ভয়ঙ্কর লাগে - তারা তা করে they আমি chm বন্ধ আমার প্রয়োজনীয়তা মডেলিং। আমি chm পছন্দ করতে না পারার একমাত্র কারণ হ'ল কোডটি ম্যাপিড এবং অন্যগুলি ব্যবহার করে তার সাথে কীভাবে যোগাযোগ করে। আমি বরং একটি সরল পাঠ্য তালিকা (যা আমার জন্য স্বয়ংক্রিয়ভাবে উত্পন্ন হয়) সঞ্চয় করি যা আমার কোড ডকুমেন্টেশনের প্রসঙ্গে সংবেদনশীল অংশটি অ্যাক্সেস করতে ব্যবহার করতে পারে।
আমি এমন একটি স্ক্রিপ্ট কল্পনা করছি যা এইচটিএমএল আউটপুট ফাইলগুলির মধ্য দিয়ে যাবে এবং একটি সূচক পৃষ্ঠা উত্পন্ন করবে যাতে এটিতে পাওয়া কীওয়ার্ডগুলির একটি তালিকা রয়েছে। স্পষ্টত: শব্দ বর্জন করার মতো শব্দগুলি যেমন: দ্য, এটি, ইত্যাদি ইত্যাদি উপেক্ষা করা উচিত This এই অংশটি লিখতে তুলনামূলক সহজ। দ্বিতীয় অংশে এইচটিএমএল পাঠ্যের মধ্যে কীওয়ার্ডের ডেটাবেস এবং তাদের অবস্থানের একত্রে রাখার জন্য কোনও ধরণের স্ক্রিপ্টের প্রয়োজন হবে। আমি মনে করি এটি ব্রাউজারের মধ্যে অনুসন্ধানের ব্যবস্থা সরবরাহের সাথে সাথে জটিল কাজ হবে।
বিকল্প সম্পর্কিত যে কোনও ধারণা প্রশংসিত হবে। আমি একটি উইকি বা কোনও ওয়েবসারভারে হোস্ট করা স্ট্যাটিক এইচটিএমএল পৃষ্ঠাগুলির সেট ব্যবহার করতে চাই, তবে আমাদের একটি অফলাইন ব্যবহারের প্রয়োজনীয়তা রয়েছে। কেবলমাত্র স্থানীয় ড্রাইভে এইচটিএমএল স্থাপন করা আমাদের প্রয়োজনীয় অনুসন্ধানের প্রয়োজনীয়তা সরবরাহ করে না।
সম্পাদনা করুন:
আমি খনিজ শিল্প দ্বারা ব্যবহৃত সফ্টওয়্যার ডিজাইন। প্রচুর খনি খুব দূরবর্তী এবং কোনও অর্থবহ উপায়ে ইন্টারনেটে অ্যাক্সেস পায় না। পিডিএফ বা এইচটিএমএল বা সিএইচএম নিয়ে কোনও সমস্যা নেই (এটি পুরানো হয়ে চলেছে)) আমি যদি সঠিক স্থানে পিডিএফ ফাইলটি প্রদর্শন করতে পারি (যেমন প্রসঙ্গে সংবেদনশীল সহায়তা) আমি এটি ব্যবহার করব। আমি প্রায় আমার নিজের লিখতে প্রলুব্ধ - মূলত এটি একটি বহনযোগ্য উইকি হবে। এর কথা বললে, আপনি যদি পোর্টেবল উইকির পরামর্শ দেন - আপনাকে শেষ ব্যবহারকারীটির কথা ভাবতে হবে যার এই জাতীয় সরঞ্জামগুলি ব্যবহার করার অভিজ্ঞতা নেই। এটি মৃত সহজ হতে হবে। এটি chm এর সৌন্দর্য ছিল, এটির সাথে কাজ করতে ব্যথা হয় তবে শেষ ব্যবহারকারীরা এটি পছন্দ করেন।