Reading/Web/PDF Functionality/ar



تحديث على عرض ملف PDF ، 15 يوليو 2019
لقد أطلقنا عارض PDF الجديد. نحن نبحث في التعليقات ، لكننا لم نشهد حتى الآن أي مشكلات مهمة. قد ندمج بعض الاقتراحات ، لكننا نريد أن نلاحظ أن هذا ليس مشروعًا مستمرًا مع التطوير المستمر. بعبارة أخرى ، الآن بعد أن تم نشره وثبت أنه يعمل ، يدخل العارض الجديد في وضع الصيانة. لن يتم التخلي عن صفحة الحديث في هذه الصفحة ، ولكن قد يستغرق الأمر بعض الوقت قبل أن يتفاعل أي شخص ، وذلك ببساطة لأن كل شخص لديه الكثير من الأشياء الأخرى.

فيما يتعلق بالكتب ، فقد تركناها في أيدي المطورين المتطوعين و PediaPress. سنكون سعداء للتواصل معهم بأسئلة ، لكننا لا نخطط لأي مشاركة فيما يتعلق بالتنفيذ الفني.



تحديث على عرض PDF ، 4 يونيو 2019
لقد قمنا بنشر العارض الجديد لملفات PDF المكونة من مادة واحدة لجميع المشاريع. نأمل أن يؤدي هذا إلى حل المشكلات المرتبطة بعارض Electron ، والذي غالبًا ما كان غير قادر على إنشاء ملفات PDF كما هو متوقع. لا تتردد في تجربة العارض الجديد وإعلامنا إذا كانت لديك أسئلة أو صادفت أي أخطاء أو مشكلات أخرى.



تحديث على عرض ملف PDF ، 18 مارس 2019
We're getting close to the deployment of our new renderer, Proton, with only a few tasks remaining as blockers (as can be seen in the task graph in T181084). سنقوم بنشر تحديث آخر بمجرد تحديد تاريخ النشر. سيحل هذا العارض محل عارض الإلكترون كعارض PDF افتراضي لملفات PDF أحادية الصفحة.



تحديث الكتب ، 17 أغسطس 2018
Here is an updated and more comprehensive sample of the new book renderer. تم تغيير التصميم تمامًا عن الإصدار الأول الذي تم تقديمه في Wikimania. شكرا لكل الردود. لا يزال التصدير يحتوي على عدد من المشكلات المهمة: يجب تحسين فواصل الصفحات ومربعات المعلومات والجداول والصيغ الرياضية بشكل كبير. This sample file focusing on international scripts and math formulas reveals some of the problems that still need to be solved. يتم عرض الصيغ الرياضية حاليًا باستخدام MathML - يجب أن يؤدي التبديل إلى LaTeX إلى تحسينات كبيرة.



تحديث الكتب ، 8 أغسطس 2018
لقد عملنا مع PediaPress على إنشاء الكتب الجديدة وتصميمها. لقد قدموا لنا عينة من المخرجات الحالية ، والتي ستكون مشابهة جدًا للإصدار النهائي. ناقشنا نقاط التحسين مع فريق PediaPress ، والتي يعالجونها حاليًا. إذا كان لديك أي ملاحظات أو تعليقات أخرى على هذه العينات ، فيرجى إخبارنا على صفحة النقاش.



تحديث الكتب أبريل 2018
ستعود وظيفة الكتب عبر PediaPress. بعد التحقق من عمق العارض الجديد ، أدركنا أن الميزات الأساسية لمنشئ الكتاب الأصلي (مثل أرقام الصفحات وجدول المحتويات) سيكون من الصعب جدًا تنفيذها باستخدام العارض الجديد. بالإضافة إلى ذلك ، كانت لدينا مشكلات كبيرة مع رمز التسلسل الخاص بنا. وبالتالي ، كان علينا البحث عن بدائل من حيث إعادة وظيفة كتب PDF في مشاريع ويكيميديا. لقد تواصلنا مع PediaPress ، الذين كانوا الرعاة الأصليين للكتب على ويكيبيديا لمعرفة ما إذا كانوا مهتمين بأخذ عرض PDF للكتب مرة أخرى. لقد وافقوا ونعمل حاليًا على التفاصيل والجدول الزمني. سيبدأون بالعمل على حل مؤقت يعتمد على تقنية قديمة تم استخدامها سابقًا لإنشاء PDF. قد يكون لهذا بعض العيوب عندما يتعلق الأمر بالعناصر الرسومية ، مثل الخرائط ، ولكنه سيعني حل عمل أسرع. ثم يخططون بعد ذلك للعمل على عارض HTML-to-PDF جديد بعد ذلك ، بناءً على التعليقات على التنفيذ الأول.



تحديث يناير 2018
نقوم حاليًا بإعداد اختبارات أداء لوظيفة PDF للحجز. يجب أن نعرف المزيد في أوائل فبراير.



تحديث سبتمبر 2017
Our current PDF rendering service, the offline content generator (OCG), is no longer maintainable. ببساطة ، إنه ينهار. The Reading team at the Wikimedia Foundation has been working towards replacing it for months. تم تشغيل OCG على رمز قديم قد يؤدي إلى ظهور ثغرات أمنية ومشكلات رئيسية أخرى في المستقبل. على مدار الأشهر الثلاثة الماضية ، كانت لدينا لافتات على صفحة إنشاء PDF تطلب feedback على النموذج الأولي لبرنامج العارض الجديد الخاص بنا. ستتمتع العارض الجديد بقدرات محسّنة من OCG - سيكون قادرًا على طباعة الجداول وصناديق المعلومات وسيحتوي على تصميم يركز على إمكانية القراءة بشكل أفضل. لقد جمعنا الكثير من التعليقات الجيدة حول النموذج الأولي ونعمل على إجراء التحديثات المطلوبة لملفات PDF الجديدة الخاصة بنا.



ملحق لاحق: إيقاف عرض كتاب PDF للمدى القصير
لسوء الحظ ، ستتطلب منا المشكلات الرئيسية مع برنامج العارض القديم (OCG) إزالته كخيار عرض قبل إكمال التحديثات الضرورية لميزة الكتب. هذا أبكر مما أردنا. بحلول الوقت الذي نزيل فيه OCG ، يكون العمل على عرض المقالات الفردية قد اكتمل. ومع ذلك ، سيتم إيقاف عرض الكتب مؤقتًا أثناء قيامنا بتقييم العمل الضروري وإكماله. اختيارنا الأولي للعارض للاستبدال ، خدمة تقديم الإلكترون ، غير قادر على دعم ملفات PDF ذات الأحجام الأكبر ويفشل عند محاولة تقديم كتاب بمقالات متعددة. سنعمل على تحديد نظام عرض جديد للكتب يمكنه التعامل مع حجم الملفات ودعم متطلباتنا. هذه ليست الطريقة التي خططنا للقيام بذلك. لم نهدف مطلقًا إلى إزالة وظيفة كتاب PDF مؤقتًا.

الجدول الزمني


 * إصدار عارض كامل الميزات للمقالات الفردية (طباعة بتنسيق pdf) - 1 أكتوبر 2017
 * إيقاف عرض كتاب PDF مؤقتًا - 1 أكتوبر 2017
 * غروب الشمس من عارض OCG - 1 أكتوبر 2017
 * إصدار عارض PDF جديد - يناير 2018 (مؤقت بناءً على نتائج البحث في أنظمة العرض البديلة)

وظائف:

للحصول على قائمة كاملة بالوظائف الحالية والقادمة ، راجع أدناه.

In addition to this page being updated, this will be communicated in a banner on PDF creation page, in Tech News and on some Wikimedia mailing lists.

مقدمة
Our current PDF rendering service, the offline content generator, is no-longer maintainable. ببساطة ، إنه ينهار. تم إنشاؤه في الأصل بواسطة طرف ثالث ، ويعمل حاليًا على رمز قديم قد يؤدي إلى ظهور ثغرات أمنية ومشكلات رئيسية أخرى في المستقبل. إذا كان لدينا وظيفة PDF ، فيجب علينا للأسف استبدالها ، أو قد نجد أنفسنا فجأة في موقف حيث يتعين علينا إزالتها دون التخطيط للقيام بذلك.

بالإضافة إلى ذلك ، فإنه لا يدعم عددًا من طلبات التقديم من المجتمع ، وأهمها القدرة على عرض الجداول. We have selected a new service, the electron rendering service, as a suitable replacement. خطوتنا التالية هي تكرار الوظيفة التي يوفرها OCG باستخدام خدمة تقديم الإلكترون. أدناه ، سنصف الأجزاء الرئيسية للوظيفة التي حددناها على أنها ضرورية. نود أن ندعو إلى محادثة حول ما هو مفقود أو غير ضروري في القائمة المقدمة. نود أيضًا تسليط الضوء على خططنا المستقبلية لتقديم ملف PDF لجمع الملاحظات الأولية.



المشكلات المعروفة

 * There is currently a bug within Firefox (upstream) that affects the styling of infoboxes displayed across multiple pages. Progress from Mozilla can be tracked here: https://bugzilla.mozilla.org/show_bug.cgi?id=688556.

Userbase
The following table shows a sample of traffic to the Electron "Download as PDF" service for over a 6 hour period. The traffic is broken down by operating system (OS), browser, and the browser major version (e.g. Windows 7, Chrome v61.*). Note well that the majority of our traffic appears to come from Windows based machines.

Current Functionality Requirements
The following is a list of the current requirements for PDF rendering for single-article PDF's and for books. The requirements different from the current implementation are displayed in bold.

History

 * Rendering PDF articles and books from Wikipedia pages is handled by a service called OCG. When rendering "books" through the book creator, it uses OCG as embedded within the Collection extension. OCG has multiple issues, especially with tables.
 * Multiple issues with OCG are identified, including complaints from the community around OCG's inability to render tables.
 * Rendering of tables ranks as number 9 on the German-speaking Community Technical Wishlist.
 * Wikimedia Deutschland begins on working on a solution for rendering tables in PDF's, and introduces Electron. They do this planning to run it alongside OCG, not to replace it.
 * At the same time as Wikimedia Deutschland is working on the Electron service, the responsible maintainers of the OCG service at the Wikimedia Foundation come to the conclusion that OCG has to be replaced.
 * The WMF Reading Team takes over the responsibility for the long term maintenance of PDF rendering and begins plans for implementing table rendering across all projects.
 * The Reading team launches a community consultation for gathering feedback on Electron.
 * The Reading Infrastructure and Web teams begin scoping the working necessary to port OCG functionality over to the Electron service.

Update After Consultation
We launched a consultation on the current implementation of the PDF renderer in early June, 2017. After reviewing the consultation responses, we have made the following observations:


 * A larger number of users preferred the single-column format over the double column format
 * Users which prefered the double-column format highlighted that their preference was based in the styling and look and feel of double columns. Some users also expressed concerns with font size and wasting paper when printing PDF's in the single-column option
 * The following feature requests were made:
 * Functional hyperlinks
 * Date and url, 'this page downloaded [date] from [URL]'
 * Customizable css for layout, title, TOC
 * Option for 2 column format
 * Include/exclude images versions
 * Modifiable margins
 * print by section - allows you to remove references, paragraphs you don’t want, index, etc
 * allowing configurable text size

Based on the feedback, we have incorporated the following into our new print styles:


 * hyperlinks
 * article information
 * smaller font and book-like styling

The remainder of the requests above will be postponed until the second iteration of the PDF renderer, in which we plan to build a settings mode that will allow for customization of the available options.

Proposal
The following is a proposal for the scope of functionality necessary for PDF rendering:


 * Individual articles will be rendered to PDF using the "Download as PDF" link in the sidebar
 * Multiple articles will be rendered to PDF using the Book Creator tool
 * All articles will contain attribution for text and images
 * All PDFs rendered will be able to print tables
 * Users will be able to customize the layout of their PDF (optional)

Design
The new PDF styles will be designed for increased readability. Based on community feedback and qualitative or quantitative testing, support for a 2-column layout may be built for the book creator and/or for individual PDFs.

Development and Deployment Roadmap
The following is a rough outline of the development and deployment roadmap. It is subject to change.


 * 1) April – May 2017:
 * 2) The Reading team builds back-end support for functionality identified above
 * 3) Communities are consulted on expanding or shrinking proposed functionality
 * 4) Qualitative test performed for styling
 * 5) June – July 2017:
 * 6) New styles implemented
 * 7) First iteration is launched along with OCG on all projects and performance is compared
 * 8) Iterations based on consultations and identified edge cases
 * 9) August 2017 – September 2017
 * 10) Additional changes made if necessary
 * 11) October 2017
 * 12) Second iteration launched without OCG on all projects

Single Articles

 * A PDF for a single article will be created by selecting the "Download as PDF" link
 * Upon selecting "Download as PDF", the PDF file will be generated. To download the file, users will select the "Download the file link"
 * Each PDF file will contain the following:
 * Article title and text
 *  Infobox  (if any)
 *  Tables  (if any)
 *  Single-column layout 
 * Page number
 * All article images and captions
 * Links to pages linked from the article (blue links and external links)
 * Text and image sources, contributors, and licenses

Phabricator Tracking
All PDF-related changes including sunsetting OCG, replacing the Electron PDF renderer, and any updates to books or the collections extension are tracked under the phabricator project Proton. The project page will display any recent updates for all tasks related to PDFs.

Functionality available in October, 2017
Note: no changes will be made to the current book creator workflow at this time


 * User will launch the books creator by selecting "Create a book"
 * This will navigate to the current book creation page
 * To download a book, users will select the "download" link from the books page
 *  Users may only download books in PDF format 
 * Books will contain all elements from single article format as well as:
 * Book title page
 * The references for each article from the book will appear at the end of the article
 * Each article will begin on a new page
 * A single section for text and image sources, contributors, and licenses, that contains the collected contributions from all articles

Functionality available in November - December, 2017

 * Books will contain a table of contents with page numbers
 * Selecting a section from the table of contents will navigate the user to the corresponding section within the book

Styles for books will be updated for improved readability

Alternative
There is an alternative way of exporting MediaWiki to LaTeX, PDF, ODT and EPUB:

http://mediawiki2latex.wmflabs.org/

The computational resources on the server are limited.

If you run Ubuntu Linux and want results faster, you can install the  or   packages.