3860b7a9fa
Moved contribution-related docs to docs/contribution/, added new guides and templates for contributors, and updated references in docs/README.md to point to the new locations. This improves organization and provides clearer onboarding and standards for new contributors.
314 lines
8.4 KiB
Bash
314 lines
8.4 KiB
Bash
#!/bin/bash
|
||
|
||
################################################################################
|
||
# ProxmoxVED Fork Setup Script
|
||
#
|
||
# Automatically configures documentation and scripts for your fork
|
||
# Detects your GitHub username and repository from git config
|
||
# Updates all hardcoded links to point to your fork
|
||
#
|
||
# Usage:
|
||
# ./setup-fork.sh # Auto-detect from git config
|
||
# ./setup-fork.sh YOUR_USERNAME # Specify username
|
||
# ./setup-fork.sh YOUR_USERNAME REPO_NAME # Specify both
|
||
#
|
||
# Examples:
|
||
# ./setup-fork.sh john # Uses john/ProxmoxVED
|
||
# ./setup-fork.sh john my-fork # Uses john/my-fork
|
||
################################################################################
|
||
|
||
set -e
|
||
|
||
# Colors for output
|
||
RED='\033[0;31m'
|
||
GREEN='\033[0;32m'
|
||
YELLOW='\033[1;33m'
|
||
BLUE='\033[0;34m'
|
||
NC='\033[0m' # No Color
|
||
|
||
# Default values
|
||
REPO_NAME="ProxmoxVED"
|
||
USERNAME=""
|
||
AUTO_DETECT=true
|
||
|
||
################################################################################
|
||
# FUNCTIONS
|
||
################################################################################
|
||
|
||
print_header() {
|
||
echo -e "\n${BLUE}╔════════════════════════════════════════════════════════════╗${NC}"
|
||
echo -e "${BLUE}║${NC} ProxmoxVED Fork Setup Script"
|
||
echo -e "${BLUE}║${NC} Configuring for your fork..."
|
||
echo -e "${BLUE}╚════════════════════════════════════════════════════════════╝${NC}\n"
|
||
}
|
||
|
||
print_info() {
|
||
echo -e "${BLUE}ℹ${NC} $1"
|
||
}
|
||
|
||
print_success() {
|
||
echo -e "${GREEN}✓${NC} $1"
|
||
}
|
||
|
||
print_warning() {
|
||
echo -e "${YELLOW}⚠${NC} $1"
|
||
}
|
||
|
||
print_error() {
|
||
echo -e "${RED}✗${NC} $1"
|
||
}
|
||
|
||
# Detect username from git remote
|
||
detect_username() {
|
||
local remote_url
|
||
|
||
# Try to get from origin
|
||
if ! remote_url=$(git config --get remote.origin.url 2>/dev/null); then
|
||
return 1
|
||
fi
|
||
|
||
# Extract username from SSH or HTTPS URL
|
||
if [[ $remote_url =~ git@github.com:([^/]+) ]]; then
|
||
echo "${BASH_REMATCH[1]}"
|
||
elif [[ $remote_url =~ github.com/([^/]+) ]]; then
|
||
echo "${BASH_REMATCH[1]}"
|
||
else
|
||
return 1
|
||
fi
|
||
}
|
||
|
||
# Detect repo name from git remote
|
||
detect_repo_name() {
|
||
local remote_url
|
||
|
||
if ! remote_url=$(git config --get remote.origin.url 2>/dev/null); then
|
||
return 1
|
||
fi
|
||
|
||
# Extract repo name (remove .git if present)
|
||
if [[ $remote_url =~ /([^/]+?)(.git)?$ ]]; then
|
||
local repo="${BASH_REMATCH[1]}"
|
||
echo "${repo%.git}"
|
||
else
|
||
return 1
|
||
fi
|
||
}
|
||
|
||
# Ask user for confirmation
|
||
confirm() {
|
||
local prompt="$1"
|
||
local response
|
||
|
||
read -p "$(echo -e ${YELLOW})$prompt (y/n)${NC} " -r response
|
||
[[ $response =~ ^[Yy]$ ]]
|
||
}
|
||
|
||
# Update links in files
|
||
update_links() {
|
||
local old_repo="community-scripts"
|
||
local old_name="ProxmoxVED"
|
||
local new_owner="$1"
|
||
local new_repo="$2"
|
||
local files_updated=0
|
||
|
||
print_info "Scanning for hardcoded links..."
|
||
|
||
# Find all markdown and shell files
|
||
local -a files_to_update=(
|
||
"docs/DEFAULTS_SYSTEM_GUIDE.md"
|
||
"docs/alpine-install.func.md"
|
||
"docs/install.func.md"
|
||
"docs/APP-install.md"
|
||
"docs/APP-ct.md"
|
||
"docs/CONTRIBUTION_GUIDE.md"
|
||
"docs/INDEX.md"
|
||
"docs/README.md"
|
||
"docs/EXIT_CODES.md"
|
||
"docs/api/README.md"
|
||
)
|
||
|
||
echo ""
|
||
|
||
for file in "${files_to_update[@]}"; do
|
||
if [[ -f "$file" ]]; then
|
||
# Count occurrences
|
||
local count=$(grep -c "github.com/$old_repo/$old_name" "$file" 2>/dev/null || echo 0)
|
||
|
||
if [[ $count -gt 0 ]]; then
|
||
# Backup original
|
||
cp "$file" "$file.backup"
|
||
|
||
# Replace links
|
||
sed -i "s|github.com/$old_repo/$old_name|github.com/$new_owner/$new_repo|g" "$file"
|
||
|
||
((files_updated++))
|
||
print_success "Updated $file ($count links)"
|
||
fi
|
||
fi
|
||
done
|
||
|
||
return $files_updated
|
||
}
|
||
|
||
# Create user git config setup info
|
||
create_git_setup_info() {
|
||
local username="$1"
|
||
|
||
cat >.git-setup-info <<'EOF'
|
||
# Git Configuration for ProxmoxVED Development
|
||
|
||
## Recommended Git Configuration
|
||
|
||
### Set up remotes for easy syncing with upstream:
|
||
|
||
```bash
|
||
# View your current remotes
|
||
git remote -v
|
||
|
||
# If you don't have 'upstream' configured, add it:
|
||
git remote add upstream https://github.com/community-scripts/ProxmoxVED.git
|
||
|
||
# Verify both remotes exist:
|
||
git remote -v
|
||
# Should show:
|
||
# origin https://github.com/YOUR_USERNAME/ProxmoxVED.git (fetch)
|
||
# origin https://github.com/YOUR_USERNAME/ProxmoxVED.git (push)
|
||
# upstream https://github.com/community-scripts/ProxmoxVED.git (fetch)
|
||
# upstream https://github.com/community-scripts/ProxmoxVED.git (push)
|
||
```
|
||
|
||
### Configure Git User (if not done globally)
|
||
|
||
```bash
|
||
git config user.name "Your Name"
|
||
git config user.email "your.email@example.com"
|
||
|
||
# Or configure globally:
|
||
git config --global user.name "Your Name"
|
||
git config --global user.email "your.email@example.com"
|
||
```
|
||
|
||
### Useful Git Workflows
|
||
|
||
**Keep your fork up-to-date:**
|
||
```bash
|
||
git fetch upstream
|
||
git rebase upstream/main
|
||
git push origin main
|
||
```
|
||
|
||
**Create feature branch:**
|
||
```bash
|
||
git checkout -b feature/my-awesome-app
|
||
# Make changes...
|
||
git commit -m "feat: add my awesome app"
|
||
git push origin feature/my-awesome-app
|
||
```
|
||
|
||
**Pull latest from upstream:**
|
||
```bash
|
||
git fetch upstream
|
||
git merge upstream/main
|
||
```
|
||
|
||
---
|
||
|
||
For more help, see: docs/CONTRIBUTION_GUIDE.md
|
||
EOF
|
||
|
||
print_success "Created .git-setup-info file"
|
||
}
|
||
|
||
################################################################################
|
||
# MAIN LOGIC
|
||
################################################################################
|
||
|
||
print_header
|
||
|
||
# Parse command line arguments
|
||
if [[ $# -gt 0 ]]; then
|
||
USERNAME="$1"
|
||
AUTO_DETECT=false
|
||
|
||
if [[ $# -gt 1 ]]; then
|
||
REPO_NAME="$2"
|
||
fi
|
||
else
|
||
# Try auto-detection
|
||
if username=$(detect_username); then
|
||
USERNAME="$username"
|
||
print_success "Detected GitHub username: $USERNAME"
|
||
else
|
||
print_error "Could not auto-detect GitHub username from git config"
|
||
echo -e "${YELLOW}Please run:${NC}"
|
||
echo " ./setup-fork.sh YOUR_USERNAME"
|
||
exit 1
|
||
fi
|
||
|
||
if repo_name=$(detect_repo_name); then
|
||
REPO_NAME="$repo_name"
|
||
if [[ "$REPO_NAME" != "ProxmoxVED" ]]; then
|
||
print_info "Detected custom repo name: $REPO_NAME"
|
||
else
|
||
print_success "Using default repo name: ProxmoxVED"
|
||
fi
|
||
fi
|
||
fi
|
||
|
||
# Validate inputs
|
||
if [[ -z "$USERNAME" ]]; then
|
||
print_error "Username cannot be empty"
|
||
exit 1
|
||
fi
|
||
|
||
if [[ -z "$REPO_NAME" ]]; then
|
||
print_error "Repository name cannot be empty"
|
||
exit 1
|
||
fi
|
||
|
||
# Show what we'll do
|
||
echo -e "${BLUE}Configuration Summary:${NC}"
|
||
echo " Repository URL: https://github.com/$USERNAME/$REPO_NAME"
|
||
echo " Files to update: 10 files with documentation"
|
||
echo ""
|
||
|
||
# Ask for confirmation
|
||
if ! confirm "Apply these changes?"; then
|
||
print_warning "Setup cancelled"
|
||
exit 0
|
||
fi
|
||
|
||
echo ""
|
||
|
||
# Update all links
|
||
if update_links "$USERNAME" "$REPO_NAME"; then
|
||
links_changed=$?
|
||
print_success "Updated $links_changed files"
|
||
else
|
||
print_warning "No links needed updating or some files not found"
|
||
fi
|
||
|
||
# Create git setup info file
|
||
create_git_setup_info "$USERNAME"
|
||
|
||
# Final summary
|
||
echo ""
|
||
echo -e "${GREEN}╔════════════════════════════════════════════════════════════╗${NC}"
|
||
echo -e "${GREEN}║${NC} Fork Setup Complete! ${GREEN}║${NC}"
|
||
echo -e "${GREEN}╚════════════════════════════════════════════════════════════╝${NC}"
|
||
echo ""
|
||
|
||
print_success "All documentation links updated to point to your fork"
|
||
print_info "Your fork: https://github.com/$USERNAME/$REPO_NAME"
|
||
print_info "Upstream: https://github.com/community-scripts/ProxmoxVED"
|
||
echo ""
|
||
|
||
echo -e "${BLUE}Next Steps:${NC}"
|
||
echo " 1. Review the changes: git diff"
|
||
echo " 2. Check .git-setup-info for recommended git workflow"
|
||
echo " 3. Start developing: git checkout -b feature/my-app"
|
||
echo " 4. Read: docs/CONTRIBUTION_GUIDE.md"
|
||
echo ""
|
||
|
||
print_success "Happy contributing! 🚀"
|