اگر میخواهید فایلهای پیدیاف را بدون دسترسی به خود سرور روی مدیاویکی آپلود کنید و کاربر بتواند PDFها را بدون نیاز به دانلود داخل سایت ورق بزند. اگر میخواهید بتوانید به یک صفحه خاص از فایل PDF لینک مستقیم دهید. اطلاعات متادیتای فایل PDF را در صفحه آپلود آن مشاهده کنید. بتوانید یک نسخه thumb از هر صفحه فایل PDF در هر کجای سایت و با هر ابعادی داشته باشید. راهحل تمام اینها استفاده از اکستنشن PDFHandler است.
با دستور زیر محل اسکریپتهای gs و convert و pdfinfo را مشخص کنید:
which gs convert pdfinfo
اگر از سیستمعامل دبیان استفاده کنید و پکیجهای این اسکریپتها نصب باشد خروجی شبیه این خواهد بود:
/usr/bin/gs
/usr/bin/convert
/usr/bin/pdfinfo
اگر نصب نبود نصب کنید:
apt-get install imagemagick xpdf-utils ghostscript pdfinfo xpdf
فایل Localsetting را باز کنید:
nano wiki/LocalSettings.php
در این فایل باید محل اسکریپتهای pdfinfo و pdftotext و convert و gs را مشخص کنید. همچنین مشخص کنید سیستم از ImageMagick برای تغییر اندازه عکسها و ساخت بندانگشتی استفاده کند یا از متد دیگری. حجم مموری مورد استفاده برای ساخت فایلهای بندانگشتی به صورت دیفالت ۱۰۲۴۰۰ است. این سایز خیلی کم است و باید اینجا زیاد شود. (واحدش کیلوبایت است.) همچنین باید به سیستم بگویید که اجازه آپلود فایل را به کاربران بدهد. همچنین باید به مدیاویکی بگویید به فرمتهای مجاز برای آپلود PDF را هم اضافه کند. برای مثال نوشته شده در بالا به اینصورت در میآید:
$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'doc',
'xls', 'mpp', 'pdf', 'ppt', 'tiff', 'bmp', 'docx', 'xlsx',
'pptx', 'ps', 'odt', 'ods', 'odp', 'odg'
);
$wgEnableUploads = true;
$wgGenerateThumbnailOnParse = true;
$wgUseImageMagick = true;
$wgImageMagickConvertCommand = "/usr/bin/convert";
$wgMaxShellMemory = $wgMaxShellMemory = 1024000;
$wgPdfProcessor = '/usr/bin/gs';
$wgPdfPostProcessor = $wgImageMagickConvertCommand;
$wgPdfOutputExtension = "jpg";
$wgPdfInfo = '/usr/bin/pdfinfo';
$wgPdftoText = '/usr/bin/pdftotext';
حالا به شاخه images بروید. در اینجا باید سه دایرکتوری را مشاهده کنید. هر کدام را اگر مشاهده نمیکنید بسازید.
temp
thumb
archive
مطمئن باشید وبسرور امکان رایت کردن در این دایرکتوریها را دارد.
محل فایل php.ini روی سرور را پیدا کنید:
locate php.ini
اگر از php-fpm استفاده میکنید به احتمال زیاد محل این فایل اینجا خواهد بود:
/etc/php5/fpm/php.ini
و اگر از apache استفاده میکنید اینجاست:
/etc/php5/apache2/php.ini
اگر فایلهای PDF شما از محدودیت حجم دیفالت مدیاویکی (۲ مگابایت هر فایل) بیشتر است این خطها را ادیت کنید:
post_max_size = 9M
به صفحه اکستنشن PdfHandler بروید و مراحل نصب را از آنجا دنبال کنید.
یک فایل PDF آپلود کنید. باید در صفحهای که فایل آپلود شده، نسخه thumb آن را در ابعاد گوناگون به علاوهٔ امکان ورق زدن فایل مشاهده کنید.
ویکیپدیا دو دسته روبات دارد. یکی روباتهاییست که سمت سرور کار میکنند. کد این روباتها را کاربرانی که سطوح دسترسی بالایی دارند مینویسند و ممکن است روی دیتابیسهای ویکیپدیا query اجرا کنند یا صفحات را کراول کنند و به صورت خودکار ویرایش انجام دهند. مسئولیت این روباتها با صاحبانشان است. دسته دیگر روباتهاییست که عموما کد آنها JS هست و سمت کاربر کار میکنند. overhead اجرای این روباتها روی کامپیوتر کاربر است نه سرورهای ویکیپدیا. این ابزارها قابلیت اجرا روی مدیاویکی را نیز دارند. برای این منظور باید افزونه گدجتس مدیاویکی را نصب کنید و بعد یک صفحه ایجاد و سورس روبات را از ویکیپدیا برداشته و در آن کپی کنید. نحوهٔ نصب و پیادهسازی این افزونه و پیادهسازی ابرابزار ویکیپدیا روی آن موضوع این مقاله است. پیشنهاد میشود حتما پیش از شروع مطالعه این مقاله برای آشنایی با نحوه استفاده، کاربرد و نحوه نمایش این ابزار در مدیاویکی صفحهٔ راهنمای آن را مطالعه کنید.
۱- نصب اکستنشن را طبق راهنمایی که در صفحه افزونه Gadgets نوشته شده دنبال کنید.
برای نصب این ابرابزارها روی ویکی خودتون باید طبق راهنمای زیر عمل کنید:
۲- این صفحات را ایجاد کنید و سورس مربوط به هر کدام را از ویکیپدیا در آنها کپی کنید:
۳- فراخوانی آنها به جای آنکه درون کدها باشد از صفحهٔ مدیاویکی:Gadgets-definition خواهد بود. صفحه فوق را ایجاد کنید کد زیر را در آن کپی کنید:
== ابرابزار ==
* Extra-Editbuttons[ResourceLoader]|Extra-Editbuttons.js|Extra-Editbuttons-persiantools.js|Extra-Editbuttons-persianwikitools.js|Extra-Editbuttons-dictionary.js|Extra-Editbuttons-autoed.js
۴- صفحهٔ مدیاویکی:Gadget-Extra-Editbuttons را ایجاد و توضیحاتی درباره پلاگین در آن بنویسید. این توضیحات در صفحهٔ ترجیحات کاربر نمایش داده میشود.
۵- کاربرها برای مشاهده این امکانات باید در ترجیحات کاربر آن را فعال کنند. برای این منظور به صفحهٔ ویژه:ترجیحات بروید. سپس تب ابزارها و تیک ابرابزار را بزنید.