الخطوط المخصصة في GroupDocs.Watermark

GroupDocs.Watermark هي مكتبة قوية لإدارة العلامات المائية في مستندات بتنسيقات مختلفة، تقدم مجموعة واسعة من خيارات التخصيص. من بين ميزاتها القوية هي القدرة على استخدام خطوط مخصصة، مما يمكّن المطورين من دمج أنماط طباعة فريدة في علاماتهم المائية.

في هذه المقالة، سوف نستكشف كيفية استخدام الخطوط المخصصة التي لم يتم تثبيتها على النظام. بالإضافة إلى ذلك، سنوضح كيفية تكوين حاوية Docker على نظام لينكس لسيناريوهات الاختبار حيث يتم تثبيت خطوط معينة مباشرة في بيئة الحاوية.

لماذا استخدام خطوط مخصصة لعلامات الماء؟
كيف تمكّن GroupDocs.Watermark الخطوط المخصصة؟
خطوة بخطوة تنفيذ في C#
اختبار GroupDocs.Watermark في حاوية Docker لنظام Linux
تمكين دعم Unix في .csproj
أفضل الممارسات لاستخدام الخطوط المخصصة
خاتمة
تحميل النسخة التجريبية المجانية
انظر أيضًا

لماذا تستخدم خطوط مخصصة للعلامات المائية؟

استخدام الخطوط المخصصة للعلامات المائية يقدم عدة مزايا:

هوية العلامة التجارية: تأكد من أن مستنداتك تتماشى مع إرشادات الطباعة الخاصة بمنظمتك.
استقلال النظام: تجنب الاعتماد على الخطوط المثبتة في النظام، مما يضمن إمكانية النقل والتوافق عبر بيئات مختلفة.

كيف يمكّن GroupDocs.Watermark الخطوط المخصصة؟

GroupDocs.Watermark يبسط استخدام الخطوط المخصصة من خلال السماح للمطورين بتحديد مجلد يحتوي على ملفات الخطوط. يمكنك بعد ذلك الإشارة إلى الخط المطلوب بواسطة اسم عائلته، مما يجعل عملية وضع العلامات مائية مرنة وسهلة الاندماج في سير العمل الخاص بك.

يتضمن التنفيذ ثلاث خطوات رئيسية:

حدد المجلد الذي يحتوي على الخطوط: حدد المسار إلى دليل يحتوي على ملفات الخط (على سبيل المثال، .ttf، .otf).
قم بتعيين الخط للعلامة المائية: استخدم فئة Font لتهيئة الخط باسم عائلته، ومسار المجلد، والحجم.
أضف علامة مائية إلى المستند: قم بتطبيق العلامة المائية المكونة على مستندك المستهدف.

خطوات تنفيذ خطوة بخطوة بلغة C#

إليك كيفية استخدام الخطوط المخصصة في حل العلامة المائية الخاصة بك مع GroupDocs.Watermark:

خطوات رئيسية:

حدد مسار الوثيقة وملف الإخراج.
اضبط مسار المجلد حيث توجد ملفات الخطوط المخصصة.
قم بتهيئة كائن Font مع اسم العائلة والخصائص.
إنشاء علامة مائية نصية وتكوين خصائصها.
أضف علامة مائية إلى المستند واحفظه.

using GroupDocs.Watermark;
using GroupDocs.Watermark.Options; 
using GroupDocs.Watermark.Watermarks; 

class Program
{
    static void Main()
    {
        string documentPath = "path-to-your-document.docx"; 
        string outputFileName = "path-to-output/document-with-watermark.docx"; 

        // Initialize the Watermarker
        using (Watermarker watermarker = new Watermarker(documentPath))
        {
            // Specify the folder containing custom font files
            string fontsFolder = "path-to-folder_with_fonts";

            // Initialize the font to be used for the watermark
            Font font = new Font("font_family_name", fontsFolder, 36, FontStyle.Bold); // Font family name, size and style

            // Create the watermark object
            TextWatermark watermark = new TextWatermark("Test watermark", font);

            // Set additional watermark properties
            watermark.ForegroundColor = Color.Blue; // Set the foreground color of the watermark
            watermark.Opacity = 0.4; // Set the opacity of the watermark
            watermark.HorizontalAlignment = HorizontalAlignment.Center; // Center horizontally
            watermark.VerticalAlignment = VerticalAlignment.Center; // Center vertically

            // Add the watermark to the document
            watermarker.Add(watermark);

            // Save the watermarked document
            watermarker.Save(outputFileName);
        }
    }
}

اختبار GroupDocs.Watermark في حاوية Docker على نظام Linux

عند اختبار GroupDocs.Watermark في حاوية Docker على نظام Linux، قد تواجه سيناريوهات حيث ترغب في افتراض أن خطوط معينة مثبتة في النظام. هذا مفيد للغاية للتحقق من الوظائف المعتمدة على الخطوط أو للبيئات التي يكون فيها تكوين مجلد الخطوط غير ممكن.

إليك كيفية تكوين حاوية Docker لتثبيت الاعتمادات المطلوبة والخطوط المخصصة.

Dockerfile للاختبار

فيما يلي مثال على ملف Dockerfile لتشغيل مشروع .NET يسمى WebApp في حاوية Docker على نظام Linux. يُظهر الملف أيضًا كيفية تثبيت خط مخصص (MyFont.ttf) والتبعيات المطلوبة لـ GroupDocs.Watermark:

# Use ASP.NET runtime as base image
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80

# Add libgdiplus and libc6-dev for graphics support
RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev

# Add `contrib` archive area to package sources list
RUN sed -i'.bak' 's/$/ contrib/' /etc/apt/sources.list

# Add default fonts
RUN apt-get update && apt-get install -y ttf-mscorefonts-installer fontconfig
RUN fc-cache -f -v # Refresh font cache

# Copy custom font to the font directory
COPY ["WebApp/MyFont.ttf", "/usr/share/fonts/truetype/"]
RUN fc-cache -f -v # Refresh font cache again

# Building the .NET application
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["WebApp/WebApp.csproj", "WebApp/"]
RUN dotnet restore "WebApp/WebApp.csproj"
COPY . .
WORKDIR "/src/WebApp"
RUN dotnet build "WebApp.csproj" -c Release -o /app/build

# Publish the application
FROM build AS publish
RUN dotnet publish "WebApp.csproj" -c Release -o /app/publish /p:UseAppHost=false

# Final stage with ASP.NET runtime
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .

# Set the entry point for the container
ENTRYPOINT ["dotnet", "WebApp.dll"]

النقاط الرئيسية في Dockerfile

تثبيت المكتبات المطلوبة:

RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev

هذه المكتبات ضرورية للتصيير السليم للصور في لينكس.

تثبيت الخطوط الافتراضية:

RUN apt-get update && apt-get install -y ttf-mscorefonts-installer fontconfig

RUN fc-cache -f -v

تقوم هذه الخطوة بتثبيت الخطوط الافتراضية، وهي مطلوبة إذا كنت تستخدم GroupDocs.Watermark دون تعيين ترخيص.

إضافة خط مخصص:

COPY ["WebApp/MyFont.ttf", "/usr/share/fonts/truetype/"]

RUN fc-cache -f -v

هذا الأمر ينسخ الخط المخصص (MyFont.ttf) إلى الدليل المناسب للخطوط في الحاوية ويحدث ذاكرة التخزين المؤقت للخطوط.

بناء وتشغيل التطبيق:

تكوين الأوامر المتبقية حاوية Docker لبناء وتشغيل تطبيق .NET الخاص بك (WebApp)، مما يضمن أن الخط المخصص متوفر أثناء وقت التشغيل.

تمكين دعم Unix في `.csproj`

بسبب القيود في مكتبة System.Drawing.Common في .NET 6 لنظام Linux، تحتاج إلى تمكين دعم Unix من خلال إضافة إعداد محدد إلى ملف .csproj الخاص بك. لمزيد من التفاصيل حول هذه القيود، راجع وثائق Microsoft.

<ItemGroup>
    <RuntimeHostConfigurationOption Include="System.Drawing.EnableUnixSupport" Value="true" />
</ItemGroup>

تضمن هذه الإعدادات أن تعمل وظائف System.Drawing بشكل صحيح في بيئة لينكس، وهو أمر ضروري للتقديم الصحيح عند استخدام GroupDocs.Watermark.

أفضل الممارسات لاستخدام الخطوط المخصصة

لاستغلال هذه الميزة إلى أقصى حد، اتبع هذه الممارسات الجيدة:

قم بتنظيم الخطوط: احتفظ بخطوطك المخصصة منظمة في مجلد مخصص لسهولة الإشارة.
تحقق من أسماء الخطوط: تأكد من تحديد اسم عائلة الخط بشكل صحيح لتجنب مشاكل العرض.
اختبار في بيئة محوسبة: استخدم حاويات Docker لاختبار تطبيقك في بيئة محكومة قائمة على Linux.

استنتاج

تمنحك القدرة على استخدام خطوط مخصصة في GroupDocs.Watermark تحكمًا أكبر في تصميم علامات المياه، مما يتيح لك تلبية متطلبات العلامة التجارية والتصميم المحددة. من خلال تحديد مجلد الخطوط أو تثبيت الخطوط في حاوية لينوكس، يمكنك اختبار وتوزيع تطبيقك بسلاسة في أي بيئة.

The provided Dockerfile and C# examples serve as a comprehensive guide for implementing and testing this functionality. Try them out to ensure your watermarking solution is flexible, portable, and ready for production.

احصل على تجربة مجانية

يمكنك تجربة واجهات برمجة التطبيقات GroupDocs.Watermark مجانًا عن طريق تنزيل النسخة الأخيرة وتثبيتها من موقع release downloads website.

يمكنك أيضًا الحصول على ترخيص مؤقت لاختبار جميع وظائف المكتبة دون أي قيود. انتقل إلى temporary license page لتقديم طلب للحصول على ترخيص مؤقت.

انظر أيضًا

للمزيد من المعلومات والموارد الإضافية، قد تجد الروابط التالية مفيدة:

لماذا تستخدم خطوط مخصصة للعلامات المائية؟#

كيف يمكّن GroupDocs.Watermark الخطوط المخصصة؟#

خطوات تنفيذ خطوة بخطوة بلغة C##

اختبار GroupDocs.Watermark في حاوية Docker على نظام Linux#

Dockerfile للاختبار#

النقاط الرئيسية في Dockerfile#

تمكين دعم Unix في .csproj#

أفضل الممارسات لاستخدام الخطوط المخصصة#

استنتاج#

احصل على تجربة مجانية#

انظر أيضًا#