Содержание
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

