Skip to content

fonts.mdx

Latest commit

 

History

History
148 lines (108 loc) · 6.54 KB

fonts.mdx

File metadata and controls

148 lines (108 loc) · 6.54 KB
title استخدام الخطوط المخصصة
sidebar
label
الخطوط
description هل ترغب في إضافة خطوط مخصصة إلى موقع ويب Astro؟ يمكنك استخدام Google Fonts مع Fontsource أو إضافة أي خط من اختيارك بسهولة.
i18nReady true

import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'; import { Steps } from '@astrojs/starlight/components'

سيرشدك هذا الدليل إلى كيفية إضافة خطوط الويب إلى مشروعك واستخدامها في مكوناتك.

استخدام ملف خط محلي

سيوضح هذا المثال كيفية إضافة خط مخصص باستخدام ملف الخط DistantGalaxy.woff.

  1. أضف ملف الخط إلى public/fonts/.

  2. أضف البيان التالي @font-face إلى CSS الخاص بك. يمكن أن يكون ذلك في ملف .css عام تستورده، أو في كتلة <style is:global>, أو في كتلة <style> في تصميم أو مكون معين حيث تريد استخدام هذا الخط.

    /*  قم بتسجيل خطك المخصص وأخبر المتصفح بمكان العثور عليه.*/
@font-face {
  font-family: 'DistantGalaxy';
  src: url('/fonts/DistantGalaxy.woff') format('woff');
  font-weight: normal;
  font-style: normal;
  font-display: swap;
}

  3. استخدم قيمة font-family من بيان @font-face لتنسيق العناصر في المكون أو التخطيط الخاص بك. في هذا المثال، سيحصل العنوان <h1> على الخط المخصص، بينما لن يتأثر الفقرة <p>.

    ---
---
<h1>في مجرة بعيدة، بعيدة جداً...</h1>

<p>الخطوط المخصصة تجعل العناوين أكثر روعة!</p>

<style>
h1 {
 font-family: 'DistantGalaxy', sans-serif;
}
</style>

استخدام Fontsource

يُبسط مشروع Fontsource استخدام خطوط Google والخطوط مفتوحة المصدر الأخرى. يوفر وحدات npm التي يمكنك تثبيتها للخطوط التي ترغب في استخدامها.

  1. ابحث عن الخط الذي تريد استخدامه في كتالوج Fontsource. في هذا المثال، سيتم استخدام Twinkle Star.

  2. قم بتثبيت الحزمة الخاصة بالخط الذي اخترته باستخدام أداة إدارة الحزم مثل npm، pnpm أو yarn.

    ```shell npm install @fontsource/twinkle-star ``` ```shell pnpm add @fontsource/twinkle-star ``` ```shell yarn add @fontsource/twinkle-star ```

    :::tip ستجد اسم الحزمة الصحيح في قسم "التثبيت السريع" في كل صفحة خط على موقع Fontsource. سيبدأ بـ @fontsource/ أو @fontsource-variable/ يليه اسم الخط. :::

  3. استورد حزمة الخط في المكون الذي ترغب في استخدام الخط فيه. عادةً، يجب أن تقوم بذلك في مكون تخطيط مشترك لضمان توفر الخط عبر موقعك.

    سيقوم الاستيراد بإضافة القواعد اللازمة لـ @font-face تلقائيًا لإعداد الخط.

    ---
import '@fontsource/twinkle-star';
---

  4. استخدم اسم الخط كما هو موضح في مثال body في صفحة Fontsource كقيمة لـ font-family. هذا سيعمل في أي مكان يمكنك كتابة CSS فيه في مشروعك باستخدام Astro.

    h1 {
  font-family: "Twinkle Star", cursive;
}

لتحسين أوقات عرض موقعك، قد ترغب في تحميل الخطوط الأساسية التي تحتاجها الصفحة في البداية. راجع دليل Fontsource لتحميل الخطوط مسبقًا لمزيد من المعلومات والاستخدام.

تسجيل الخطوط في Tailwind

إذا كنت تستخدم تكامل Tailwind، يمكنك استخدام أي من الطرق السابقة في هذه الصفحة لتثبيت الخط، مع بعض التعديلات. يمكنك إما إضافة جملة @font-face لخط محلي أو استخدام استراتيجية الاستيراد الخاصة بـ Fontsource لتثبيت خطك.

لتسجيل خطك في Tailwind:

  1. اتبع أيًا من الأدلة السابقة، ولكن تخطَّ الخطوة الأخيرة من إضافة font-family إلى CSS.

  2. أضف اسم الخط إلى tailwind.config.mjs.

    هذا المثال يضيف Inter إلى مجموعة الخطوط بدون سيريف، مع الخطوط الاحتياطية الافتراضية من Tailwind CSS.

    import defaultTheme from 'tailwindcss/defaultTheme'

/** @type {import('tailwindcss').Config} */
export default {
	content: ['./src/**/*.{astro,html,js,jsx,md,mdx,svelte,ts,tsx,vue}'],
	theme: {
		extend: {
			fontFamily: {
				sans: ['Inter', ...defaultTheme.fontFamily.sans],
			},
		},
	},
	plugins: [],
}

    الآن، سيستخدم كل النص بدون سيريف (الافتراضي في Tailwind) في مشروعك الخط الذي اخترته، وستقوم أيضًا فئة font-sans بتطبيق خط Inter.

راجع توثيق Tailwind حول إضافة عائلات الخطوط المخصصة لمزيد من المعلومات.

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