Initial commit
This commit is contained in:
74
assets/templates/commands/host/docs
Normal file
74
assets/templates/commands/host/docs
Normal file
@@ -0,0 +1,74 @@
|
||||
#!/bin/bash
|
||||
|
||||
## Description: Render TYPO3 extension documentation to HTML
|
||||
## Usage: docs
|
||||
## Example: "ddev docs"
|
||||
|
||||
set -e
|
||||
|
||||
PROJECT_DIR="$(pwd)"
|
||||
DOC_SOURCE="${PROJECT_DIR}/Documentation"
|
||||
DOC_OUTPUT="${PROJECT_DIR}/Documentation-GENERATED-temp"
|
||||
|
||||
echo "📚 Rendering TYPO3 Extension Documentation"
|
||||
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
||||
|
||||
# Check if Documentation directory exists
|
||||
if [ ! -d "$DOC_SOURCE" ]; then
|
||||
echo "❌ Error: Documentation directory not found"
|
||||
echo "💡 Tip: Create a Documentation/ directory with Index.rst to get started"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Check if Index.rst exists
|
||||
if [ ! -f "$DOC_SOURCE/Index.rst" ]; then
|
||||
echo "❌ Error: Index.rst not found in Documentation/"
|
||||
echo "💡 Tip: Create Documentation/Index.rst as the main entry point"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo "📖 Source: Documentation/"
|
||||
echo "📦 Output: Documentation-GENERATED-temp/"
|
||||
echo ""
|
||||
|
||||
# Clean previous output
|
||||
if [ -d "$DOC_OUTPUT" ]; then
|
||||
echo "🧹 Cleaning previous documentation build..."
|
||||
rm -rf "$DOC_OUTPUT"
|
||||
fi
|
||||
|
||||
# Render documentation using TYPO3's official docker image
|
||||
echo "🔨 Rendering documentation with TYPO3 render-guides..."
|
||||
echo ""
|
||||
|
||||
docker run --rm \
|
||||
-v "${PROJECT_DIR}:/project" \
|
||||
--user "$(id -u):$(id -g)" \
|
||||
ghcr.io/typo3-documentation/render-guides:latest \
|
||||
--no-progress \
|
||||
--output=/project/Documentation-GENERATED-temp \
|
||||
/project/Documentation 2>&1
|
||||
|
||||
if [ $? -eq 0 ]; then
|
||||
# Check for output files (structure may vary)
|
||||
if [ -f "$DOC_OUTPUT/Result/project/0.0.0/Index.html" ] || \
|
||||
[ -f "$DOC_OUTPUT/Index.html" ] || \
|
||||
[ -d "$DOC_OUTPUT" ]; then
|
||||
echo ""
|
||||
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
||||
echo "✅ Documentation rendered successfully!"
|
||||
echo ""
|
||||
echo "🌐 View at: https://docs.$(ddev describe -j | jq -r .raw.name).ddev.site/"
|
||||
echo "📁 Output: Documentation-GENERATED-temp/"
|
||||
echo ""
|
||||
else
|
||||
echo ""
|
||||
echo "⚠️ Build completed but output structure unclear"
|
||||
echo "📁 Check: Documentation-GENERATED-temp/"
|
||||
fi
|
||||
else
|
||||
echo ""
|
||||
echo "❌ Documentation rendering failed"
|
||||
echo "💡 Check your .rst files for syntax errors"
|
||||
exit 1
|
||||
fi
|
||||
17
assets/templates/commands/host/pre-start-git-info
Normal file
17
assets/templates/commands/host/pre-start-git-info
Normal file
@@ -0,0 +1,17 @@
|
||||
#!/bin/bash
|
||||
|
||||
## Description: Capture git info for landing page before container build
|
||||
## Usage: Runs automatically before ddev start
|
||||
## Example: "ddev start"
|
||||
|
||||
# Get git info from host
|
||||
GIT_BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "unknown")
|
||||
GIT_COMMIT=$(git rev-parse --short HEAD 2>/dev/null || echo "unknown")
|
||||
GIT_PR=$(gh pr view --json number 2>/dev/null | jq -r '.number // "unknown"' || echo "unknown")
|
||||
|
||||
# Export for docker-compose to use
|
||||
export DDEV_GIT_BRANCH="$GIT_BRANCH"
|
||||
export DDEV_GIT_COMMIT="$GIT_COMMIT"
|
||||
export DDEV_GIT_PR="$GIT_PR"
|
||||
|
||||
echo "Git info captured: $GIT_BRANCH @ $GIT_COMMIT (PR: $GIT_PR)"
|
||||
41
assets/templates/commands/host/setup
Normal file
41
assets/templates/commands/host/setup
Normal file
@@ -0,0 +1,41 @@
|
||||
#!/bin/bash
|
||||
|
||||
## Description: Complete setup - docs, install TYPO3, configure extension
|
||||
## Usage: setup
|
||||
## Example: "ddev setup"
|
||||
|
||||
set -e
|
||||
|
||||
echo "🚀 Complete DDEV Environment Setup"
|
||||
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
||||
echo ""
|
||||
|
||||
# Step 1: Render documentation
|
||||
echo "📚 Step 1/3: Rendering documentation..."
|
||||
if [ -d "/var/www/${EXTENSION_KEY}/Documentation" ]; then
|
||||
ddev docs
|
||||
else
|
||||
echo "⚠️ No Documentation/ directory found, skipping docs rendering"
|
||||
fi
|
||||
echo ""
|
||||
|
||||
# Step 2: Install TYPO3
|
||||
echo "🌐 Step 2/3: Installing TYPO3..."
|
||||
ddev exec /mnt/ddev_config/commands/web/install-all
|
||||
echo ""
|
||||
|
||||
# Done
|
||||
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
||||
echo "✅ Setup Complete!"
|
||||
echo ""
|
||||
echo "🌐 Access Your Environment:"
|
||||
echo " Overview: https://${DDEV_SITENAME}.ddev.site/"
|
||||
echo " Documentation: https://docs.${DDEV_SITENAME}.ddev.site/"
|
||||
echo " TYPO3 v11: https://v11.${DDEV_SITENAME}.ddev.site/"
|
||||
echo " TYPO3 v12: https://v12.${DDEV_SITENAME}.ddev.site/"
|
||||
echo " TYPO3 v13: https://v13.${DDEV_SITENAME}.ddev.site/"
|
||||
echo ""
|
||||
echo "🔑 Backend Login:"
|
||||
echo " Username: admin"
|
||||
echo " Password: Password:joh316"
|
||||
echo ""
|
||||
Reference in New Issue
Block a user