Este proyecto contiene el código fuente para el sitio web de YiiframeWork.com.
Si desea contribuir, póngase en contacto con nosotros utilizando el rastreador de problemas.
Instale Docker y Docker Compose.
docker-compose build
docker-compose up
El sitio estará disponible en http: // localhost: 81.
Puede usar el script run_pageres.sh en la raíz del directorio de origen para generar capturas de pantalla.
Ajuste los archivos de configuración locales si es necesario:
config/console-local.php .config/params-local.php .config/web-local.php . Genere un token GitHub personal (desde su sección de configuración de perfil de GitHub). Pételo en un archivo en el directorio data (@App/Data) llamado github.token (una línea, sin descanso de línea).
Continuar con los siguientes comandos:
# run migrations
./yii migrate
# fill RBAC
./yii rbac/up
# build contributors page (this may take some time as it downloads a lot of user avatars from github)
./yii contributors/generate
# If you're on Windows you have to manually symlink or copy
# %appdata%/npm/node_modules/browser-sync to your app's node_modules
# The next step is for building the API documentation and the Guide files.
# It is optional for the site to be working but you will have no API docs and Guide.
# This step includes cloning the Yii 1 and Yii 2 repositories and a lot of computation,
# so you might want to skip it on the first install.
#
# This also requires an instance of elasticsearch to be configured and running
# (if you do not have it, it will still run, but the site search will not work).
# It also assumes you have pdflatex installed for building PDF guide docs.
#
# You may also build only parts of the docs, run make help for the available commands.
make docs
# If you are using Docker image, you need to additionally pass VENDOR_DIR:
make docs VENDOR_DIR= $VENDOR_DIR
# Yii 1.0 API docs generation. They are already included in VCS. Run this only if layout has changed.
docker build -f Dockerfile.yii-1.0 -t yiiframeworkcom-yii-1.0 .
docker run -it -v $PWD /data/api-1.0:/code/data/api-1.0 yiiframeworkcom-yii-1.0
# populate the search index by running
./yii search/rebuild
/code/vendor/bin/apidoc guide data/yii-2.0/docs/guide-ru data/docs-offline/yii-docs-2.0-ru --interactive=0
./yii guide " 2.0 " --interactive=0Para importar datos del sitio web anterior, son necesarios los siguientes pasos:
./yii import./yii badge/rebuild./yii user/ranking .Si no tiene esos datos, puede trabajar con contenido ficticio:
./yii fake-data . Puede ejecutarlo varias veces para generar más datos../yii badge/rebuild ../yii user/ranking . Para asignar usuarios uso de permisos adicionales ./yii rbac/assign .
Los siguientes comandos deben configurarse para ejecutarse regularmente:
| dominio | intervalo | Objetivo |
|---|---|---|
| yii Sitemap/Generar | a diario | regenerar siteMap.xml |
| contribuyentes de yii/generar | semanalmente | Actualizar la lista de contribuyentes en la página del equipo |
| Insignia/actualización YII | cada hora | Actualizar insignias para los usuarios en Badge_queue |
| yii cron/update-packagist | cada hora | Actualizar datos de extensión de packagist |
| Usuario/ranking de YII | a diario | Actualizar clasificación de usuario |
| yii github progreso | cada hora | Actualizar datos de progreso de GitHub |
Además, queue/listen debe funcionar como un demonio o queue/run como un cronjob.
Esta sección cubre notas para la implementación en un servidor, es posible que no necesite esto para su dev env. Se supone que el sistema operativo es Debian "Bullseye".
apt-get install texlive-full python3-pygments git nodejs makeLa lista de contribuyentes y las miniaturas Avatar se generan mediante un comando de consola:
./yii contributors/generate Se conectará a GitHub a través de la API y obtendrá una lista de contribuyentes, generará data/contributors.json Imágenes de JSON y miniatura de los avatares del usuario en data/avatars y finalmente invocar Gulp para generar una imagen Sprite y un código SASS.
Sería una buena idea establecer un trabajo de Cron para ejecutarlo de vez en cuando, tal vez de vez en cuando cada mes.
commands/ contains console commands (controllers)
config/ contains application configurations
controllers/ contains Web controller classes
data/ contains important data generated by different commands
env/ contains environment-dependent files
assets/
src/
fonts/ contains fonts
scss/ contains Sass source files
js/ contains JS source files
mail/ contains view files for e-mails
models/ contains model classes
node_modules/ contains installed NPM packages
runtime/ contains files generated during runtime
scripts/ contains shell scripts
vendor/ contains dependent 3rd-party packages
views/ contains view files for the Web application
web/ contains the entry script and Web resources
gulp para ver los cambios de archivo, SASS y JS y construya automáticamente archivos CSS/JS de destino. Este comando también iniciará una ventana de navegador que está conectada a BrowserSync.gulp build para reconstruir manualmente los archivos Target CSS/JS de los archivos SASS/JS de origen.gulp watch de comandoproduction : gulp build --production o Run npm run buildassets/src/scss y enumerados en assets/src/scss/all.scss .GuideController tiene un archivo SASS llamado _guide.scss .all.scss . Sass ignorará los archivos que comienzan con un bajo para que solo se produzca un archivo CSS (All.CSS).all.scss .assets/src/js y enumerados en config.yml .GuideController tiene un archivo JS llamado guide.js .