Инструменты пользователя

Инструменты сайта


software:development:demo:cms:ucms:readme

6.2. Файл readme.txt

Введение

Файл README (с англ. «прочти меня») — это текстовый документ, содержащий основную информацию о проекте, программе или репозитории. Это первое руководство, которое читает пользователь, чтобы понять, как установить, запустить и использовать программное обеспечение. Обычно файл находится в корневой папке проекта (часто с расширением .md или .txt).
Ключевые особенности и содержимое README:

  • Цель: Описание, назначение и инструкции по использованию проекта.
  • Формат: Часто используется формат Markdown (README.md), который позволяет красиво форматировать текст, добавлять картинки, списки и ссылки.
  • Что включает: Название, описание возможностей, инструкции по установке и запуску, информацию об авторах и лицензии.
  • Применение: Важен для разработчиков (на GitHub) и пользователей программного обеспечения для быстрого ознакомления с продуктом.

README позволяет сразу понять, что делает проект, и как его использовать, что экономит время и выделяет качественные продукты.

Файл readme.txt

Этот файл не участвует в работе приложения, это - вспомогательный файл руководства для упрощения понимания работы приложения. Да, мы будем много писать, и в этом файле мы будем описывать что за файлы у нас на сервере, зачем они и что за функции выполняют. Создадим в корне нашего приложения файл с именем readme.txt

По мере создания папок и файлов приложения, мы будем добовлять записи в этот файл и в конце нашей работы мы получим рабочий файл руковдства. А в начале нашего пути в нем будет записан текст наших, в будущем созданных директорий.

Пример файла readme.txt

readme.txt
//////////////////////////////////////// ДИРЕКТОРИИ ////////////////////////////////////////////
  * ./ucms/ - главная директория (папка) приложения
  * users - главная папка пользователей
    * admin - главная директория администратора приложения
    * account_admin - папка аккаунта администратора (полные права, включая настройку сайта и регистрацию прав пользователя/удаление пользователей и модерацию сообщений)
    * admin_setting.php - файл настроек CMS администратором
    * admin_nav.php - расширенное меню пользователя-администратора
	* admin.php - файл главной страницы администратора приложения
  * guest - пользователь с правом только просмотра и поиска по сайту контента.
  * account_user - папка аккаунта пользователя (пользователь с правом просмотра, загрузки, редактирования и удаления своего контента, поиска контента, написания комментариев, голосования и прочего.
    * user_login.php - файл авторизации пользователя
    * user_logout.php - файл окончания сеанса авторизации пользователя
    * user_signup.php - файл регистрации нового пользователя
    * user_edit.php - редактор постов пользователя
    * user_nav.php - меню пользователя	
  * install - папка установки CMS
  * .htaccess — это локальный конфигурационный файл веб-сервера Apache, который позволяет управлять настройками сайта.
  * index.php - это стартовая страница.
  * readme.html - руководство, которое дает пользователям подробное описание проекта
 
//////////////////////////////////////// ФУНЦИИ ////////////////////////////////////////////
и т.д.

более подробно смотрите в файле readme.txt

Только авторизованные участники могут оставлять комментарии.
software/development/demo/cms/ucms/readme.txt · Последнее изменение: VladPolskiy

Если не указано иное, содержимое этой вики предоставляется на условиях следующей лицензии: Public Domain
Public Domain Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki