الصفحة الرئيسية>كود مصدر ASP>فئات أخرى
تنزيل

Static Site Starter هو قالب بداية للمواقع الثابتة.
Stack: Babel ، Browsersync ، Gulp ، Minireset.css ، Pug ، Sass ، WebPack .

جدول المحتويات

  • المتطلبات الأساسية
  • الأوامر
  • هيكل المشروع
  • هيكل التصميم
  • خرق ذاكرة التخزين المؤقت
  • تعيين علامات التعريف
  • المؤلفون
  • المساهمة
  • رخصة

المتطلبات الأساسية

  • ASDF
  • يصنع
  • node.js
  • غزل

⌨ الأوامر

يخدم 

 # # Serve site at http://localhost:3000 with live reloading

make

سيقوم هذا الأمر أيضًا بتثبيت تبعيات على التشغيل الأول وعندما يتم تحديث ملفات package.json أو yarn.lock .

يبني 

 # # Build site for production use

make build

سيقوم هذا الأمر أيضًا بتثبيت تبعيات على التشغيل الأول وعندما يتم تحديث ملفات package.json أو yarn.lock .

يساعد 

 # # List available commands

make help

بنية المشروع 

 .
├── documentation-images    # PROJECT DOCUMENTATION IMAGES
│
│
├── gulp                    # GULP/WEBPACK CONFIGURATION AND TASKS
│   ├── env                 # Gulp configuration per environment
│   │   ├── dev.js          # Development environment
│   │   └── prod.js         # Production environment
│   │
│   ├── helpers             # Gulp helpers
│   │   └── url.js          # Helper for URL creation
│   │
│   ├── tasks               # Gulp tasks
│   │   ├── pug.js          # Pug task declaration
│   │   ├── sass.js         # Sass task declaration
│   │   └── script.js       # JavaScript task declaration
│   │
│   ├── webpack             # Webpack configuration per environment
│   │   ├── common.js       # Shared between development and production environments
│   │   ├── dev.js          # Development environment
│   │   └── prod.js         # Production environment
│   │
│   └── index.js            # Script to invoke proper environment and dynamically load Gulp tasks
│
│
├── js                      # JAVASCRIPT SOURCE FILES
│   ├── foo.js              # Sample script imported in scripts.js
│   └── scripts.js          # Main JavaScript file used as entry by Webpack
│
│
├── sass                    # SASS STYLE
│   ├── base                # Base style
│   │   ├── _all.sass       # Importing all stylesheets
│   │   ├── generic.sass    # Style for generic elements (html, body, etc.)
│   │   └── helpers.sass    # Helper classes (modifiers)
│   │
│   ├── dev                 # Development utilities
│   │   ├── shame.sass      # WIP style or dirty hacks
│   │   └── structure.sass  # Highlighting site structure (import commented by default)
│   │
│   ├── fonts               # Fonts style
│   │   ├── _all.sass       # Importing all stylesheets
│   │   └── roboto.sass     # @font-face style for Roboto
│   │
│   ├── layout              # Layout style
│   │   ├── _all.sass       # Importing all stylesheets
│   │   └── layout.sass     # Very light starter style for structure elements and titles
│   │
│   ├── utilities           # Utilities
│   │   ├── _all.sass       # Importing all stylesheets
│   │   ├── animations.sass # Some basic animations
│   │   ├── functions.sass  # Functions
│   │   ├── mixins.sass     # A few useful mixins
│   │   └── variables.sass  # Variables for colors, typography, etc.
│   │
│   └── style.sass          # Main Sass file used as source by Gulp
│
│
├── site                    # SITE BUILD DESTINATION FOLDER
│   ├── fonts               # Font assets
│   │   └── roboto          # Roboto from Google Fonts (TTF, WOFF, WOFF2)
│   │
│   └── images              # Image assets
│       ├── favicon.ico     # Favicon (placeholder by default)
│       ├── og-image.jpg    # Image for og:image meta tag (placeholder by default)
│       └── unicorn.jpg     # Sample image
│
│
├── templates               # PUG TEMPLATES
│   ├── layouts             # Layouts
│   │   └── default.pug     # Default layout
│   │
│   ├── partials            # Partials
│   │   └── unicorn.pug     # Sample partial featuring an image
│   │
│   ├── index.pug           # Home page
│   └── page.pug            # Sample page
│
│
├── .babelrc                # Presets and plugins to use, used by Babel
├── .gitignore              # Files and folders ignored by Git
├── .tool-versions          # Which version to use locally for each language, used by asdf
├── gulpfile.js             # Gulp configuration
├── LICENSE                 # License
├── Makefile                # Commands for this project
├── package.json            # JavaScript dependencies, used by Yarn
├── README.md               # Project documentation
└── yarn.lock               # Tracking exact versions for JavaScript dependencies, used by Yarn

؟ هيكل التصميم

يأتي المبتدئ مع تصميم بسيط ، منظم مثل ما يلي: 

 // Wrapper
.wrapper
  // Header
  header .header
    .container
      …

  // Main
  main .main
    // Section (repeatable)
    section .section
      .container
        …

  // Footer
  footer .footer
    .container
      …

تسليط الضوء على بنية الموقع

هناك أيضًا أداة SASS تسمح بتسليط الضوء على بنية الموقع (مفيدة للغاية في التطوير). ببساطة uncomment @import "dev/structure.sass" في style.sass إذا كنت تريد استخدامه.

؟ خرق ذاكرة التخزين المؤقت

استراتيجيتنا لخرق ذاكرة التخزين المؤقت هي إلحاق A ?v=[version] إلى كل استعلام أصول. عندما تحتاج إلى تمثال ذاكرة التخزين المؤقت ، ما عليك سوى تحديث version في package.json .

في قوالب الصلصال ، يتوفر متغير assetVersion . الاستخدام: 

img ( src = "images/unicorn.jpg" + assetVersion, alt = "" )

في ملفات SASS ، تتوفر وظيفة urlVersion . الاستخدام: 

background-image: urlVersion("/images/unicorn .jpg ")

تعيين علامات التعريف

مطلوب للقيام ببعض التكوين للحصول title description و og: علامات التعريف جاهزة للإنتاج. يمكنك قراءة المزيد حول علامات META OG في وثائق بروتوكول الرسم البياني المفتوح.

الخطوة 1: اضبط المتغيرات التالية في default.pug : 

 - var siteTitle = " Site title " ;
- var siteDescription = " Site description " ;
- var baseUrl = " https://site-url.com " ;

الخطوة 2: تعيين متغير pageTitle لكل صفحة. على سبيل المثال في index.pug : 

 - pageTitle = " Home " ;

الخطوة 3: تخصيص صورة OG.

✍ المؤلفون

  • abea - الفكرة والعمل الأولي
  • mmaayylliiss - تصميم ، رمز/مراجعة الوثائق

؟ المساهمة

المساهمات والقضايا وطلبات الميزات موضع ترحيب! راجع قائمة المساهمين الذين شاركوا في هذا المشروع.

؟ رخصة

يتم ترخيص بداية الموقع الثابت بموجب ترخيص GNU General Public V3.0.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل