用Python生成个性化的电子邮件签名
目录
- 用Python生成个性化的电子邮件签名
- 1. 引言
- 2. 系统架构设计
- 2.1 整体架构概述
- 2.2 核心模块设计
- 2.3 技术选型理由
- 3. 环境配置与依赖安装
- 3.1 系统要求
- 3.2 依赖包安装
- 3.3 项目结构设计
- 4. 数据模型设计
- 4.1 签名数据模型
- 4.2 数据验证器
- 5. HTML签名生成器
- 5.1 基础HTML生成器
- 5.2 图像处理器
- 6. 模板系统设计
- 6.1 企业风格模板
- 6.2 现代风格模板
- 6.3 CSS样式文件
- 7. 纯文本签名生成器
- 8. 命令行界面
- 9. 完整示例和使用方法
- 9.1 基本使用示例
- 9.2 配置文件示例
- 10. 测试和验证
- 10.1 单元测试
- 11. 部署和使用说明
- 11.1 安装和使用
- 11.2 最佳实践
- 12. 总结
『宝藏代码胶囊开张啦！』—— 我的 CodeCapsule 来咯！✨写代码不再头疼！我的新站点 CodeCapsule 主打一个 “白菜价”+“量身定制”！无论是卡脖子的毕设/课设/文献复现，需要灵光一现的算法改进，还是想给项目加个“外挂”，这里都有便宜又好用的代码方案等你发现！低成本，高适配，助你轻松通关！速来围观 👉 CodeCapsule官网
用Python生成个性化的电子邮件签名
1. 引言
在数字通信时代，电子邮件仍然是商务沟通和个人交流的重要工具。据统计，全球每天发送的电子邮件数量超过3000亿封，而专业的电子邮件签名不仅能够提供必要的联系信息，还能增强品牌形象、建立信任关系并促进业务增长。
一个精心设计的电子邮件签名具有以下重要作用：
- 专业形象：展示个人或公司的专业素养
- 品牌推广：强化品牌识别和一致性
- 信息完整：提供全面的联系方式和社交媒体链接
- 营销机会：包含推广信息和行动号召
- 法律合规：满足商业通信的法律要求
然而，手动创建和维护电子邮件签名存在诸多挑战：
- 格式不一致，影响专业形象
- 更新联系信息繁琐且容易出错
- 难以在不同邮件客户端保持显示一致性
- 缺乏个性化定制能力
本文将详细介绍如何使用Python构建一个智能的个性化电子邮件签名生成系统。通过这个系统，用户可以快速生成美观、专业且一致的电子邮件签名，支持动态内容、响应式设计和多平台兼容。
2. 系统架构设计
2.1 整体架构概述
电子邮件签名生成系统的核心架构采用模块化设计，确保代码的可维护性和扩展性。
2.2 核心模块设计
系统包含以下关键模块：
- 数据模型：定义签名数据的结构和验证规则
- 模板引擎：基于Jinja2的HTML模板渲染
- 样式处理器：管理CSS样式和响应式设计
- 图像处理器：处理头像、Logo等图像资源
- 输出生成器：生成HTML、纯文本等多种格式
2.3 技术选型理由
选择Python作为开发语言的主要原因：
- 丰富的库生态：拥有强大的HTML/CSS处理库
- 模板引擎成熟：Jinja2模板引擎功能强大
- 图像处理能力：Pillow库提供专业的图像处理功能
- 跨平台兼容：确保在不同操作系统上的一致性
- 易于部署：简单的部署和维护流程
3. 环境配置与依赖安装
3.1 系统要求
- Python 3.8+
- 支持HTML5和CSS3的现代浏览器
- 足够的磁盘空间存储模板和生成的文件
3.2 依赖包安装
创建requirements.txt文件：
Jinja2==3.1.2
Pillow==10.0.0
python-dotenv==1.0.0
click==8.1.4
colorama==0.4.6
requests==2.28.2
beautifulsoup4==4.12.2
lxml==4.9.2
qrcode==7.4.2
安装依赖：
pip install -r requirements.txt
3.3 项目结构设计
email_signature_generator/
├── src/
│ ├── __init__.py
│ ├── models/
│ │ ├── __init__.py
│ │ ├── signature_data.py
│ │ └── validators.py
│ ├── generators/
│ │ ├── __init__.py
│ │ ├── html_generator.py
│ │ ├── text_generator.py
│ │ └── image_processor.py
│ ├── templates/
│ │ ├── html/
│ │ │ ├── corporate.html
│ │ │ ├── modern.html
│ │ │ └── minimal.html
│ │ └── css/
│ │ ├── corporate.css
│ │ ├── modern.css
│ │ └── minimal.css
│ ├── utils/
│ │ ├── __init__.py
│ │ ├── helpers.py
│ │ └── config.py
│ └── cli.py
├── tests/
├── examples/
├── docs/
├── requirements.txt
└── README.md
4. 数据模型设计
4.1 签名数据模型
创建基础数据模型来存储签名信息：
# src/models/signature_data.py
from dataclasses import dataclass, field
from typing import List, Optional, Dict, Any
from datetime import datetime
import re
from enum import Enumclass SocialPlatform(Enum):"""支持的社交媒体平台枚举"""LINKEDIN = "linkedin"TWITTER = "twitter"FACEBOOK = "facebook"INSTAGRAM = "instagram"GITHUB = "github"WEBSITE = "website"YOUTUBE = "youtube"class ThemeStyle(Enum):"""主题样式枚举"""CORPORATE = "corporate"MODERN = "modern"MINIMAL = "minimal"CREATIVE = "creative"@dataclass
class SocialMedia:"""社交媒体链接数据类"""platform: SocialPlatformurl: strusername: Optional[str] = None@propertydef display_name(self) -> str:"""获取平台显示名称"""platform_names = {SocialPlatform.LINKEDIN: "LinkedIn",SocialPlatform.TWITTER: "Twitter",SocialPlatform.FACEBOOK: "Facebook",SocialPlatform.INSTAGRAM: "Instagram",SocialPlatform.GITHUB: "GitHub",SocialPlatform.WEBSITE: "Website",SocialPlatform.YOUTUBE: "YouTube"}return platform_names.get(self.platform, self.platform.value)@dataclass
class ContactInfo:"""联系信息数据类"""phone: Optional[str] = Nonemobile: Optional[str] = Noneemail: Optional[str] = Noneaddress: Optional[str] = Nonewebsite: Optional[str] = Nonedef get_display_phone(self) -> Optional[str]:"""格式化显示电话号码"""if not self.phone:return None# 简单的电话号码格式化cleaned = re.sub(r'\D', '', self.phone)if len(cleaned) == 10:return f"({cleaned[:3]}) {cleaned[3:6]}-{cleaned[6:]}"return self.phone@dataclass
class SignatureData:"""电子邮件签名主数据类"""# 基本信息full_name: strjob_title: strcompany: strdepartment: Optional[str] = None# 联系信息contact: ContactInfo = field(default_factory=ContactInfo)# 社交媒体social_media: List[SocialMedia] = field(default_factory=list)# 品牌信息logo_url: Optional[str] = Noneprofile_picture_url: Optional[str] = Nonebrand_color: Optional[str] = Nonesecondary_color: Optional[str] = None# 营销信息promotional_text: Optional[str] = Nonecall_to_action: Optional[str] = Nonedisclaimer: Optional[str] = None# 样式配置theme: ThemeStyle = ThemeStyle.MODERNinclude_border: bool = Trueinclude_qr_code: bool = Falseqr_code_url: Optional[str] = None# 元数据created_at: datetime = field(default_factory=datetime.now)updated_at: datetime = field(default_factory=datetime.now)def add_social_media(self, platform: SocialPlatform, url: str, username: Optional[str] = None):"""添加社交媒体链接"""social = SocialMedia(platform=platform, url=url, username=username)self.social_media.append(social)def remove_social_media(self, platform: SocialPlatform):"""移除社交媒体链接"""self.social_media = [sm for sm in self.social_media if sm.platform != platform]def get_social_media_by_platform(self, platform: SocialPlatform) -> Optional[SocialMedia]:"""根据平台获取社交媒体信息"""for social in self.social_media:if social.platform == platform:return socialreturn Nonedef to_dict(self) -> Dict[str, Any]:"""转换为字典格式"""return {'full_name': self.full_name,'job_title': self.job_title,'company': self.company,'department': self.department,'contact': {'phone': self.contact.phone,'mobile': self.contact.mobile,'email': self.contact.email,'address': self.contact.address,'website': self.contact.website},'social_media': [{'platform': sm.platform.value,'url': sm.url,'username': sm.username} for sm in self.social_media],'theme': self.theme.value,'brand_color': self.brand_color,'secondary_color': self.secondary_color,'promotional_text': self.promotional_text,'call_to_action': self.call_to_action,'disclaimer': self.disclaimer}@classmethoddef from_dict(cls, data: Dict[str, Any]) -> 'SignatureData':"""从字典创建实例"""contact_data = data.get('contact', {})contact = ContactInfo(phone=contact_data.get('phone'),mobile=contact_data.get('mobile'),email=contact_data.get('email'),address=contact_data.get('address'),website=contact_data.get('website'))signature = cls(full_name=data['full_name'],job_title=data['job_title'],company=data['company'],department=data.get('department'),contact=contact,brand_color=data.get('brand_color'),secondary_color=data.get('secondary_color'),promotional_text=data.get('promotional_text'),call_to_action=data.get('call_to_action'),disclaimer=data.get('disclaimer'),theme=ThemeStyle(data.get('theme', 'modern')))# 添加社交媒体for sm_data in data.get('social_media', []):platform = SocialPlatform(sm_data['platform'])signature.add_social_media(platform, sm_data['url'], sm_data.get('username'))return signature
4.2 数据验证器
创建数据验证器确保输入数据的有效性：
# src/models/validators.py
import re
from typing import Optional, Tuple
from urllib.parse import urlparse
from datetime import datetimeclass SignatureValidator:"""签名数据验证器"""@staticmethoddef validate_email(email: str) -> Tuple[bool, str]:"""验证电子邮件地址"""if not email:return True, "" # 空值视为有效pattern = r'^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$'if re.match(pattern, email):return True, ""return False, "无效的电子邮件格式"@staticmethoddef validate_phone(phone: str) -> Tuple[bool, str]:"""验证电话号码"""if not phone:return True, "" # 空值视为有效# 移除所有非数字字符cleaned = re.sub(r'\D', '', phone)if 7 <= len(cleaned) <= 15:return True, ""return False, "电话号码长度应在7-15位数字之间"@staticmethoddef validate_url(url: str) -> Tuple[bool, str]:"""验证URL格式"""if not url:return True, "" # 空值视为有效try:result = urlparse(url)if all([result.scheme, result.netloc]):return True, ""return False, "无效的URL格式"except:return False, "无效的URL格式"@staticmethoddef validate_hex_color(color: str) -> Tuple[bool, str]:"""验证十六进制颜色值"""if not color:return True, "" # 空值视为有效pattern = r'^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$'if re.match(pattern, color):return True, ""return False, "颜色格式应为 #RGB 或 #RRGGBB"@staticmethoddef validate_full_name(name: str) -> Tuple[bool, str]:"""验证全名"""if not name or len(name.strip()) < 2:return False, "姓名不能少于2个字符"if len(name) > 100:return False, "姓名不能超过100个字符"return True, ""@staticmethoddef validate_company(company: str) -> Tuple[bool, str]:"""验证公司名称"""if not company or len(company.strip()) < 1:return False, "公司名称不能为空"if len(company) > 200:return False, "公司名称不能超过200个字符"return True, ""@staticmethoddef validate_job_title(title: str) -> Tuple[bool, str]:"""验证职位名称"""if not title or len(title.strip()) < 1:return False, "职位名称不能为空"if len(title) > 100:return False, "职位名称不能超过100个字符"return True, ""def validate_signature_data(self, data: 'SignatureData') -> Tuple[bool, Dict[str, str]]:"""验证完整的签名数据"""errors = {}# 验证基本信息is_valid, message = self.validate_full_name(data.full_name)if not is_valid:errors['full_name'] = messageis_valid, message = self.validate_job_title(data.job_title)if not is_valid:errors['job_title'] = messageis_valid, message = self.validate_company(data.company)if not is_valid:errors['company'] = message# 验证联系信息if data.contact.email:is_valid, message = self.validate_email(data.contact.email)if not is_valid:errors['email'] = messageif data.contact.phone:is_valid, message = self.validate_phone(data.contact.phone)if not is_valid:errors['phone'] = messageif data.contact.website:is_valid, message = self.validate_url(data.contact.website)if not is_valid:errors['website'] = message# 验证社交媒体链接for social in data.social_media:is_valid, message = self.validate_url(social.url)if not is_valid:errors[f'social_{social.platform.value}'] = f"{social.display_name}: {message}"# 验证品牌颜色if data.brand_color:is_valid, message = self.validate_hex_color(data.brand_color)if not is_valid:errors['brand_color'] = messageif data.secondary_color:is_valid, message = self.validate_hex_color(data.secondary_color)if not is_valid:errors['secondary_color'] = messagereturn len(errors) == 0, errors
5. HTML签名生成器
5.1 基础HTML生成器
创建核心的HTML签名生成器：
# src/generators/html_generator.py
import os
import json
from typing import Dict, Any, Optional
from jinja2 import Environment, FileSystemLoader, Template
from ..models.signature_data import SignatureData, ThemeStyle
from .image_processor import ImageProcessorclass HTMLSignatureGenerator:"""HTML电子邮件签名生成器"""def __init__(self, templates_dir: str = None):"""初始化生成器参数:templates_dir: 模板目录路径"""if templates_dir is None:# 默认模板目录current_dir = os.path.dirname(os.path.abspath(__file__))templates_dir = os.path.join(current_dir, '..', 'templates', 'html')self.templates_dir = templates_dirself.env = Environment(loader=FileSystemLoader(templates_dir),trim_blocks=True,lstrip_blocks=True)self.image_processor = ImageProcessor()# 注册自定义过滤器self.env.filters['escape_html'] = self._escape_htmlself.env.filters['format_phone'] = self._format_phonedef _escape_html(self, text: str) -> str:"""转义HTML特殊字符"""if not text:return ""return (text.replace('&', '&').replace('<', '<').replace('>', '>').replace('"', '"').replace("'", '''))def _format_phone(self, phone: str) -> str:"""格式化电话号码显示"""if not phone:return ""# 移除所有非数字字符cleaned = ''.join(filter(str.isdigit, phone))if len(cleaned) == 10:return f"({cleaned[:3]}) {cleaned[3:6]}-{cleaned[6:]}"return phonedef _get_template_context(self, data: SignatureData) -> Dict[str, Any]:"""构建模板上下文数据"""# 处理品牌颜色brand_color = data.brand_color or '#2c5aa0'secondary_color = data.secondary_color or '#666666'# 处理社交媒体图标social_icons = self._prepare_social_media(data.social_media)# 准备联系信息contact_info = {'phone': data.contact.get_display_phone(),'mobile': data.contact.mobile,'email': data.contact.email,'address': data.contact.address,'website': data.contact.website}return {'data': data,'brand_color': brand_color,'secondary_color': secondary_color,'social_icons': social_icons,'contact_info': contact_info,'has_logo': bool(data.logo_url),'has_profile_picture': bool(data.profile_picture_url),'has_promotion': bool(data.promotional_text),'has_disclaimer': bool(data.disclaimer)}def _prepare_social_media(self, social_media_list) -> list:"""准备社交媒体数据"""social_data = []for social in social_media_list:# 社交媒体平台对应的图标类和颜色platform_config = {'linkedin': {'icon': 'fab fa-linkedin', 'color': '#0077b5'},'twitter': {'icon': 'fab fa-twitter', 'color': '#1da1f2'},'facebook': {'icon': 'fab fa-facebook', 'color': '#1877f2'},'instagram': {'icon': 'fab fa-instagram', 'color': '#e4405f'},'github': {'icon': 'fab fa-github', 'color': '#333333'},'website': {'icon': 'fas fa-globe', 'color': '#666666'},'youtube': {'icon': 'fab fa-youtube', 'color': '#ff0000'}}config = platform_config.get(social.platform.value, {})social_data.append({'platform': social.platform.value,'display_name': social.display_name,'url': social.url,'username': social.username,'icon_class': config.get('icon', 'fas fa-link'),'color': config.get('color', '#666666')})return social_datadef generate_signature(self, data: SignatureData, template_name: Optional[str] = None) -> str:"""生成HTML签名参数:data: 签名数据template_name: 模板名称返回:HTML签名字符串"""if template_name is None:template_name = f"{data.theme.value}.html"# 验证模板是否存在template_path = os.path.join(self.templates_dir, template_name)if not os.path.exists(template_path):raise FileNotFoundError(f"模板文件不存在: {template_path}")# 加载模板template = self.env.get_template(template_name)# 准备上下文数据context = self._get_template_context(data)# 渲染模板html_content = template.render(**context)# 清理和优化HTMLhtml_content = self._clean_html(html_content)return html_contentdef _clean_html(self, html: str) -> str:"""清理和优化HTML输出"""# 移除多余的空格和换行html = ' '.join(html.split())# 确保HTML格式正确html = html.replace('> <', '><') # 移除标签间的空格return htmldef generate_with_css(self, data: SignatureData, template_name: Optional[str] = None) -> Dict[str, str]:"""生成包含CSS的完整签名参数:data: 签名数据template_name: 模板名称返回:包含HTML和CSS的字典"""html_content = self.generate_signature(data, template_name)# 加载对应的CSS文件css_content = self._load_css_template(data.theme)return {'html': html_content,'css': css_content,'inline_css': self._generate_inline_css(css_content)}def _load_css_template(self, theme: ThemeStyle) -> str:"""加载CSS模板"""css_filename = f"{theme.value}.css"css_path = os.path.join(self.templates_dir, '..', 'css', css_filename)if os.path.exists(css_path):with open(css_path, 'r', encoding='utf-8') as f:return f.read()return ""def _generate_inline_css(self, css_content: str) -> str:"""生成内联CSS样式"""# 这里可以添加CSS内联化逻辑# 简化版本，直接返回CSS内容return f"<style>{css_content}</style>"def save_signature(self, data: SignatureData, output_path: str,template_name: Optional[str] = None,include_css: bool = True):"""保存签名到文件参数:data: 签名数据output_path: 输出文件路径template_name: 模板名称include_css: 是否包含CSS"""if include_css:result = self.generate_with_css(data, template_name)content = result['html'] + '\n' + result['inline_css']else:content = self.generate_signature(data, template_name)# 确保输出目录存在os.makedirs(os.path.dirname(output_path), exist_ok=True)with open(output_path, 'w', encoding='utf-8') as f:f.write(content)print(f"签名已保存到: {output_path}")
5.2 图像处理器
创建图像处理模块：
# src/generators/image_processor.py
import os
import requests
from PIL import Image, ImageDraw, ImageFont
import base64
from io import BytesIO
from typing import Optional, Tuple
import qrcodeclass ImageProcessor:"""图像处理器"""def __init__(self, cache_dir: str = "image_cache"):"""初始化图像处理器参数:cache_dir: 图像缓存目录"""self.cache_dir = cache_diros.makedirs(cache_dir, exist_ok=True)def download_image(self, url: str, max_size: Tuple[int, int] = (200, 200)) -> Optional[str]:"""下载并调整图像大小参数:url: 图像URLmax_size: 最大尺寸 (宽, 高)返回:本地文件路径或None"""try:# 检查缓存filename = self._get_filename_from_url(url)cache_path = os.path.join(self.cache_dir, filename)if os.path.exists(cache_path):return cache_path# 下载图像response = requests.get(url, timeout=10)response.raise_for_status()# 打开并调整图像image = Image.open(BytesIO(response.content))image.thumbnail(max_size, Image.Resampling.LANCZOS)# 保存为PNG格式image.save(cache_path, 'PNG')return cache_pathexcept Exception as e:print(f"下载图像失败: {e}")return Nonedef _get_filename_from_url(self, url: str) -> str:"""从URL生成文件名"""import hashlibreturn hashlib.md5(url.encode()).hexdigest() + '.png'def image_to_base64(self, image_path: str) -> Optional[str]:"""将图像转换为Base64编码参数:image_path: 图像文件路径返回:Base64编码的字符串或None"""try:with open(image_path, 'rb') as f:image_data = f.read()base64_encoded = base64.b64encode(image_data).decode('utf-8')return f"data:image/png;base64,{base64_encoded}"except Exception as e:print(f"图像Base64编码失败: {e}")return Nonedef create_qr_code(self, data: str, size: int = 100) -> Optional[str]:"""生成QR码参数:data: QR码数据size: 图像尺寸返回:Base64编码的QR码图像"""try:qr = qrcode.QRCode(version=1,error_correction=qrcode.constants.ERROR_CORRECT_L,box_size=10,border=4,)qr.add_data(data)qr.make(fit=True)qr_image = qr.make_image(fill_color="black", back_color="white")qr_image = qr_image.resize((size, size))# 转换为Base64buffer = BytesIO()qr_image.save(buffer, format='PNG')base64_encoded = base64.b64encode(buffer.getvalue()).decode('utf-8')return f"data:image/png;base64,{base64_encoded}"except Exception as e:print(f"生成QR码失败: {e}")return Nonedef validate_image(self, image_path: str, max_size_mb: int = 2) -> Tuple[bool, str]:"""验证图像文件参数:image_path: 图像文件路径max_size_mb: 最大文件大小(MB)返回:(是否有效, 错误信息)"""try:# 检查文件大小file_size = os.path.getsize(image_path) / (1024 * 1024) # MBif file_size > max_size_mb:return False, f"图像文件过大 ({file_size:.1f}MB > {max_size_mb}MB)"# 检查图像格式with Image.open(image_path) as img:if img.format not in ['JPEG', 'PNG', 'GIF']:return False, f"不支持的图像格式: {img.format}"# 检查图像尺寸width, height = img.sizeif width > 1000 or height > 1000:return False, f"图像尺寸过大: {width}x{height}"return True, ""except Exception as e:return False, f"图像验证失败: {str(e)}"
6. 模板系统设计
6.1 企业风格模板
创建企业风格HTML模板：
<!-- src/templates/html/corporate.html -->
<table cellpadding="0" cellspacing="0" border="0" width="600" style="border-collapse: collapse; font-family: Arial, sans-serif; font-size: 12px; line-height: 1.4; color: #333333; border: {% if data.include_border %}1px solid #dddddd{% else %}none{% endif %};"><tr>{% if data.logo_url %}<td width="100" valign="top" style="padding: 15px;"><img src="{{ data.logo_url }}" alt="{{ data.company }} Logo" width="80" style="display: block; border: none;" /></td>{% endif %}<td valign="top" style="padding: 15px; {% if not data.logo_url %}padding-left: 0;{% endif %}"><!-- 姓名和职位 --><table cellpadding="0" cellspacing="0" border="0"><tr><td style="padding-bottom: 5px;"><strong style="font-size: 14px; color: {{ brand_color }};">{{ data.full_name|escape_html }}</strong></td></tr><tr><td style="padding-bottom: 8px;"><span style="font-size: 12px; color: {{ secondary_color }};">{{ data.job_title|escape_html }}</span>{% if data.department %}<span style="color: #999999;"> | </span><span style="font-size: 12px; color: #999999;">{{ data.department|escape_html }}</span>{% endif %}</td></tr></table><!-- 公司信息 --><table cellpadding="0" cellspacing="0" border="0" style="margin-bottom: 10px;"><tr><td style="font-size: 12px; color: {{ brand_color }}; font-weight: bold;">{{ data.company|escape_html }}</td></tr></table><!-- 联系信息 --><table cellpadding="0" cellspacing="0" border="0" style="margin-bottom: 10px;">{% if contact_info.phone %}<tr><td width="20" valign="top">📞</td><td style="padding-bottom: 2px;"><span style="font-size: 11px;">电话: {{ contact_info.phone|format_phone }}</span></td></tr>{% endif %}{% if contact_info.mobile %}<tr><td width="20" valign="top">📱</td><td style="padding-bottom: 2px;"><span style="font-size: 11px;">手机: {{ contact_info.mobile|format_phone }}</span></td></tr>{% endif %}{% if contact_info.email %}<tr><td width="20" valign="top">✉️</td><td style="padding-bottom: 2px;"><a href="mailto:{{ contact_info.email }}" style="font-size: 11px; color: {{ brand_color }}; text-decoration: none;">{{ contact_info.email|escape_html }}</a></td></tr>{% endif %}{% if contact_info.website %}<tr><td width="20" valign="top">🌐</td><td style="padding-bottom: 2px;"><a href="{{ contact_info.website }}" style="font-size: 11px; color: {{ brand_color }}; text-decoration: none;">{{ contact_info.website|escape_html }}</a></td></tr>{% endif %}</table><!-- 社交媒体 -->{% if social_icons %}<table cellpadding="0" cellspacing="0" border="0" style="margin-bottom: 10px;"><tr><td style="padding-bottom: 5px;"><span style="font-size: 11px; color: #999999;">关注我们:</span></td></tr><tr><td>{% for social in social_icons %}<a href="{{ social.url }}" style="text-decoration: none; margin-right: 8px; display: inline-block;"><span style="color: {{ social.color }}; font-size: 14px;">[{{ social.display_name }}]</span></a>{% endfor %}</td></tr></table>{% endif %}<!-- 推广信息 -->{% if data.promotional_text %}<table cellpadding="0" cellspacing="0" border="0" style="margin-bottom: 10px; background-color: #f8f9fa; padding: 8px; border-left: 3px solid {{ brand_color }};"><tr><td><span style="font-size: 11px; color: #666666; font-style: italic;">{{ data.promotional_text|escape_html }}</span></td></tr></table>{% endif %}<!-- 免责声明 -->{% if data.disclaimer %}<table cellpadding="0" cellspacing="0" border="0"><tr><td><span style="font-size: 9px; color: #999999; line-height: 1.2;">{{ data.disclaimer|escape_html }}</span></td></tr></table>{% endif %}</td><!-- QR码 -->{% if data.include_qr_code and data.qr_code_url %}<td width="80" valign="middle" align="center" style="padding: 15px;"><img src="{{ data.qr_code_url }}" alt="QR Code" width="60" style="display: block; border: none;" /><span style="font-size: 9px; color: #999999;">扫描联系我</span></td>{% endif %}</tr>
</table>
6.2 现代风格模板
创建现代风格HTML模板：
<!-- src/templates/html/modern.html -->
<table cellpadding="0" cellspacing="0" border="0" width="100%" style="max-width: 550px; border-collapse: collapse; font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif; font-size: 13px; line-height: 1.5; color: #444444; background: linear-gradient(135deg, #ffffff 0%, #f8f9fa 100%); border-radius: 8px; overflow: hidden; box-shadow: 0 2px 10px rgba(0,0,0,0.1);"><tr><!-- 左侧品牌区域 --><td width="30%" valign="top" style="background: {{ brand_color }}; padding: 20px; color: white;">{% if data.logo_url %}<div style="margin-bottom: 15px;"><img src="{{ data.logo_url }}" alt="{{ data.company }} Logo" width="60" style="display: block; border: none; background: white; padding: 5px; border-radius: 4px;" /></div>{% endif %}<div style="font-size: 16px; font-weight: bold; margin-bottom: 5px;">{{ data.full_name|escape_html }}</div><div style="font-size: 12px; opacity: 0.9;">{{ data.job_title|escape_html }}</div>{% if data.department %}<div style="font-size: 11px; opacity: 0.8; margin-top: 3px;">{{ data.department|escape_html }}</div>{% endif %}</td><!-- 右侧内容区域 --><td valign="top" style="padding: 20px;"><!-- 公司名称 --><div style="font-size: 14px; font-weight: bold; color: {{ brand_color }}; margin-bottom: 15px;">{{ data.company|escape_html }}</div><!-- 联系信息 --><table cellpadding="0" cellspacing="0" border="0" width="100%" style="margin-bottom: 15px;">{% if contact_info.phone %}<tr><td width="20" valign="top" style="padding-bottom: 6px;"><span style="color: {{ brand_color }};">●</span></td><td style="padding-bottom: 6px;"><span style="font-size: 12px;">{{ contact_info.phone|format_phone }}</span></td></tr>{% endif %}{% if contact_info.email %}<tr><td width="20" valign="top" style="padding-bottom: 6px;"><span style="color: {{ brand_color }};">●</span></td><td style="padding-bottom: 6px;"><a href="mailto:{{ contact_info.email }}" style="font-size: 12px; color: {{ brand_color }}; text-decoration: none;">{{ contact_info.email|escape_html }}</a></td></tr>{% endif %}{% if contact_info.website %}<tr><td width="20" valign="top" style="padding-bottom: 6px;"><span style="color: {{ brand_color }};">●</span></td><td style="padding-bottom: 6px;"><a href="{{ contact_info.website }}" style="font-size: 12px; color: {{ brand_color }}; text-decoration: none;">{{ contact_info.website|escape_html }}</a></td></tr>{% endif %}</table><!-- 社交媒体 -->{% if social_icons %}<div style="margin-bottom: 15px;"><table cellpadding="0" cellspacing="0" border="0"><tr>{% for social in social_icons %}<td style="padding-right: 8px;"><a href="{{ social.url }}" style="display: inline-block; width: 24px; height: 24px; background-color: {{ social.color }}; border-radius: 50%; text-align: center; line-height: 24px; text-decoration: none; color: white; font-size: 12px;">{{ social.display_name|first|upper }}</a></td>{% endfor %}</tr></table></div>{% endif %}<!-- 行动号召 -->{% if data.call_to_action %}<div style="background-color: {{ brand_color }}; color: white; padding: 8px 12px; border-radius: 4px; text-align: center; margin-bottom: 10px;"><span style="font-size: 11px; font-weight: bold;">{{ data.call_to_action|escape_html }}</span></div>{% endif %}</td></tr><!-- 底部区域 -->{% if data.promotional_text or data.disclaimer %}<tr><td colspan="2" style="background-color: #f8f9fa; padding: 15px 20px; border-top: 1px solid #e9ecef;">{% if data.promotional_text %}<div style="font-size: 11px; color: #666666; margin-bottom: 8px;">✨ {{ data.promotional_text|escape_html }}</div>{% endif %}{% if data.disclaimer %}<div style="font-size: 9px; color: #999999; line-height: 1.3;">{{ data.disclaimer|escape_html }}</div>{% endif %}</td></tr>{% endif %}
</table>
6.3 CSS样式文件
创建对应的CSS样式文件：
/* src/templates/css/corporate.css */
.corporate-signature {font-family: Arial, sans-serif;font-size: 12px;line-height: 1.4;color: #333333;border-collapse: collapse;
}.corporate-signature a {color: #2c5aa0;text-decoration: none;
}.corporate-signature a:hover {text-decoration: underline;
}.corporate-signature .brand-color {color: #2c5aa0;
}.corporate-signature .secondary-color {color: #666666;
}.corporate-signature .promotional-box {background-color: #f8f9fa;padding: 8px;border-left: 3px solid #2c5aa0;font-style: italic;
}.corporate-signature .disclaimer {font-size: 9px;color: #999999;line-height: 1.2;
}
/* src/templates/css/modern.css */
.modern-signature {font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;font-size: 13px;line-height: 1.5;color: #444444;border-collapse: collapse;border-radius: 8px;overflow: hidden;box-shadow: 0 2px 10px rgba(0,0,0,0.1);
}.modern-signature a {text-decoration: none;
}.modern-signature .brand-section {background: linear-gradient(135deg, #2c5aa0 0%, #1e3a8a 100%);color: white;
}.modern-signature .social-icon {display: inline-block;width: 24px;height: 24px;border-radius: 50%;text-align: center;line-height: 24px;color: white;font-size: 12px;
}.modern-signature .cta-button {background-color: #2c5aa0;color: white;padding: 8px 12px;border-radius: 4px;text-align: center;font-weight: bold;
}.modern-signature .footer-section {background-color: #f8f9fa;border-top: 1px solid #e9ecef;
}
7. 纯文本签名生成器
创建纯文本签名生成器，确保在不支持HTML的客户端中正常显示：
# src/generators/text_generator.py
from ..models.signature_data import SignatureData
from typing import Listclass TextSignatureGenerator:"""纯文本电子邮件签名生成器"""def __init__(self, line_width: int = 70):"""初始化生成器参数:line_width: 行宽（字符数）"""self.line_width = line_widthdef generate_signature(self, data: SignatureData) -> str:"""生成纯文本签名参数:data: 签名数据返回:纯文本签名字符串"""lines = []# 分隔线lines.append("=" * self.line_width)# 姓名和职位name_line = data.full_nameif data.job_title:name_line += f" | {data.job_title}"lines.append(name_line)# 公司和部门company_line = data.companyif data.department:company_line += f" | {data.department}"lines.append(company_line)lines.append("") # 空行# 联系信息if data.contact.phone:lines.append(f"电话: {data.contact.get_display_phone()}")if data.contact.mobile:lines.append(f"手机: {data.contact.mobile}")if data.contact.email:lines.append(f"邮箱: {data.contact.email}")if data.contact.website:lines.append(f"网站: {data.contact.website}")if data.contact.address:# 地址可能较长，需要换行处理address_lines = self._wrap_text(f"地址: {data.contact.address}", self.line_width)lines.extend(address_lines)# 社交媒体if data.social_media:lines.append("") # 空行lines.append("关注我:")for social in data.social_media:lines.append(f" {social.display_name}: {social.url}")# 推广信息if data.promotional_text:lines.append("") # 空行promo_lines = self._wrap_text(f"✨ {data.promotional_text}", self.line_width)lines.extend(promo_lines)# 行动号召if data.call_to_action:lines.append("") # 空行cta_lines = self._wrap_text(f"🚀 {data.call_to_action}", self.line_width)lines.extend(cta_lines)# 免责声明if data.disclaimer:lines.append("") # 空行disclaimer_lines = self._wrap_text(data.disclaimer, self.line_width)lines.extend(disclaimer_lines)# 结束分隔线lines.append("=" * self.line_width)return "\n".join(lines)def _wrap_text(self, text: str, width: int) -> List[str]:"""文本换行处理参数:text: 原始文本width: 行宽返回:换行后的文本列表"""words = text.split()lines = []current_line = []current_length = 0for word in words:# 计算添加这个词后的行长度word_length = len(word)if current_line:# 加上空格的长度word_length += 1if current_length + word_length <= width:current_line.append(word)current_length += word_lengthelse:# 开始新行if current_line:lines.append(' '.join(current_line))current_line = [word]current_length = len(word)# 添加最后一行if current_line:lines.append(' '.join(current_line))return linesdef save_signature(self, data: SignatureData, output_path: str):"""保存纯文本签名到文件参数:data: 签名数据output_path: 输出文件路径"""text_content = self.generate_signature(data)# 确保输出目录存在import osos.makedirs(os.path.dirname(output_path), exist_ok=True)with open(output_path, 'w', encoding='utf-8') as f:f.write(text_content)print(f"纯文本签名已保存到: {output_path}")
8. 命令行界面
创建用户友好的命令行界面：
# src/cli.py
import click
import json
import os
from typing import Dict, Any
from .models.signature_data import SignatureData, ThemeStyle, SocialPlatform, ContactInfo
from .models.validators import SignatureValidator
from .generators.html_generator import HTMLSignatureGenerator
from .generators.text_generator import TextSignatureGenerator@click.group()
def cli():"""个性化电子邮件签名生成工具"""pass@cli.command()
@click.option('--name', prompt='姓名', help='您的全名')
@click.option('--title', prompt='职位', help='您的职位名称')
@click.option('--company', prompt='公司', help='公司名称')
@click.option('--department', help='部门名称')
@click.option('--email', prompt='电子邮件', help='电子邮件地址')
@click.option('--phone', help='电话号码')
@click.option('--website', help='个人或公司网站')
@click.option('--theme', type=click.Choice(['corporate', 'modern', 'minimal']), default='modern', help='签名主题风格')
@click.option('--output', '-o', default='signature.html', help='输出文件路径')
@click.option('--format', '-f', type=click.Choice(['html', 'text', 'both']), default='html', help='输出格式')
def create(name, title, company, department, email, phone, website, theme, output, format):"""创建新的电子邮件签名"""# 创建联系信息contact = ContactInfo(email=email,phone=phone,website=website)# 创建签名数据signature_data = SignatureData(full_name=name,job_title=title,company=company,department=department,contact=contact,theme=ThemeStyle(theme))# 验证数据validator = SignatureValidator()is_valid, errors = validator.validate_signature_data(signature_data)if not is_valid:click.echo("数据验证失败:")for field, error in errors.items():click.echo(f" {field}: {error}")return# 生成签名if format in ['html', 'both']:html_generator = HTMLSignatureGenerator()html_output = output if format == 'html' else output.replace('.html', '_html.html')html_generator.save_signature(signature_data, html_output)if format in ['text', 'both']:text_generator = TextSignatureGenerator()text_output = output if format == 'text' else output.replace('.html', '_text.txt')text_generator.save_signature(signature_data, text_output)click.echo("签名创建成功！")@cli.command()
@click.argument('config_file', type=click.File('r'))
@click.option('--output', '-o', required=True, help='输出文件路径')
@click.option('--format', '-f', type=click.Choice(['html', 'text', 'both']), default='html', help='输出格式')
def from_config(config_file, output, format):"""从配置文件创建签名"""try:config_data = json.load(config_file)signature_data = SignatureData.from_dict(config_data)# 验证数据validator = SignatureValidator()is_valid, errors = validator.validate_signature_data(signature_data)if not is_valid:click.echo("配置数据验证失败:")for field, error in errors.items():click.echo(f" {field}: {error}")return# 生成签名if format in ['html', 'both']:html_generator = HTMLSignatureGenerator()html_output = output if format == 'html' else output.replace('.html', '_html.html')html_generator.save_signature(signature_data, html_output)if format in ['text', 'both']:text_generator = TextSignatureGenerator()text_output = output if format == 'text' else output.replace('.html', '_text.txt')text_generator.save_signature(signature_data, text_output)click.echo("签名创建成功！")except json.JSONDecodeError:click.echo("配置文件格式错误，请检查JSON格式")except Exception as e:click.echo(f"处理配置文件时出错: {e}")@cli.command()
@click.option('--name', help='姓名')
@click.option('--title', help='职位')
@click.option('--company', help='公司')
@click.option('--output', default='signature_config.json', help='输出配置文件路径')
def create_config(name, title, company, output):"""创建签名配置文件模板"""config_template = {"full_name": name or "张三","job_title": title or "软件工程师","company": company or "示例公司","department": "技术部","contact": {"phone": "+86-10-12345678","mobile": "+86-138-0000-0000","email": "zhangsan@example.com","address": "北京市朝阳区示例街道123号","website": "https://www.example.com"},"social_media": [{"platform": "linkedin","url": "https://linkedin.com/in/zhangsan","username": "zhangsan"},{"platform": "github","url": "https://github.com/zhangsan","username": "zhangsan"}],"theme": "modern","brand_color": "#2c5aa0","secondary_color": "#666666","promotional_text": "欢迎了解我们的最新产品和服务！","call_to_action": "立即预约演示","disclaimer": "本邮件及其附件包含保密信息，仅限指定收件人使用。"}with open(output, 'w', encoding='utf-8') as f:json.dump(config_template, f, ensure_ascii=False, indent=2)click.echo(f"配置文件模板已创建: {output}")click.echo("请编辑此文件后使用 'from-config' 命令生成签名")@cli.command()
@click.argument('input_file')
@click.option('--theme', type=click.Choice(['corporate', 'modern', 'minimal']), help='主题风格')
@click.option('--output', '-o', help='输出文件路径')
def preview(input_file, theme, output):"""预览签名效果"""try:with open(input_file, 'r', encoding='utf-8') as f:if input_file.endswith('.json'):config_data = json.load(f)signature_data = SignatureData.from_dict(config_data)else:# 这里可以添加其他格式的支持raise click.ClickException("不支持的输入文件格式")if theme:signature_data.theme = ThemeStyle(theme)# 生成HTML预览html_generator = HTMLSignatureGenerator()html_content = html_generator.generate_signature(signature_data)if output:html_generator.save_signature(signature_data, output)click.echo(f"预览文件已保存: {output}")else:# 在控制台显示HTML代码click.echo("生成的HTML签名:")click.echo("=" * 80)click.echo(html_content)click.echo("=" * 80)click.echo("请将上述代码复制到您的电子邮件客户端中使用")except Exception as e:click.echo(f"预览失败: {e}")if __name__ == '__main__':cli()
9. 完整示例和使用方法
9.1 基本使用示例
创建使用示例文件：
# examples/basic_usage.py
import os
import sys
sys.path.append(os.path.join(os.path.dirname(__file__), '..'))from src.models.signature_data import SignatureData, ContactInfo, SocialPlatform, ThemeStyle
from src.generators.html_generator import HTMLSignatureGenerator
from src.generators.text_generator import TextSignatureGeneratordef create_basic_signature():"""创建基础签名示例"""# 创建联系信息contact = ContactInfo(phone="+86-10-12345678",mobile="+86-138-0000-0000",email="zhangsan@example.com",website="https://www.example.com",address="北京市朝阳区示例街道123号")# 创建签名数据signature_data = SignatureData(full_name="张三",job_title="高级软件工程师",company="创新科技有限公司",department="技术研发部",contact=contact,brand_color="#2c5aa0",secondary_color="#666666",theme=ThemeStyle.MODERN,promotional_text="专注于人工智能和云计算解决方案",call_to_action="查看我们的最新产品",disclaimer="本邮件及其附件包含保密信息，仅限指定收件人使用。")# 添加社交媒体signature_data.add_social_media(SocialPlatform.LINKEDIN, "https://linkedin.com/in/zhangsan","zhangsan")signature_data.add_social_media(SocialPlatform.GITHUB,"https://github.com/zhangsan","zhangsan")signature_data.add_social_media(SocialPlatform.WEBSITE,"https://www.zhangsan.com")return signature_datadef generate_all_formats():"""生成所有格式的签名"""signature_data = create_basic_signature()# 生成HTML签名html_generator = HTMLSignatureGenerator()html_signature = html_generator.generate_signature(signature_data)# 生成纯文本签名text_generator = TextSignatureGenerator()text_signature = text_generator.generate_signature(signature_data)# 保存文件with open('examples/output/signature.html', 'w', encoding='utf-8') as f:f.write(html_signature)with open('examples/output/signature.txt', 'w', encoding='utf-8') as f:f.write(text_signature)print("HTML签名已保存: examples/output/signature.html")print("纯文本签名已保存: examples/output/signature.txt")return html_signature, text_signatureif __name__ == '__main__':# 确保输出目录存在os.makedirs('examples/output', exist_ok=True)html, text = generate_all_formats()print("\n生成的HTML签名预览:")print("=" * 50)print(html[:500] + "..." if len(html) > 500 else html)print("\n生成的纯文本签名:")print("=" * 50)print(text)
9.2 配置文件示例
创建配置文件示例：
{"full_name": "李四","job_title": "产品经理","company": "数字创新有限公司","department": "产品部","contact": {"phone": "+86-21-87654321","mobile": "+86-139-1111-2222","email": "lisi@digital-innovations.com","address": "上海市浦东新区创新路456号","website": "https://www.digital-innovations.com"},"social_media": [{"platform": "linkedin","url": "https://linkedin.com/in/lisi","username": "lisi"},{"platform": "twitter","url": "https://twitter.com/lisi","username": "lisi"},{"platform": "website","url": "https://www.lisi.blog"}],"theme": "corporate","brand_color": "#d35400","secondary_color": "#7f8c8d","promotional_text": "我们致力于打造用户体验卓越的数字产品","call_to_action": "立即体验我们的产品演示","disclaimer": "本邮件内容仅供参考，不构成任何承诺或保证。","include_border": true,"include_qr_code": true,"qr_code_url": "https://www.digital-innovations.com/contact"
}
10. 测试和验证
10.1 单元测试
创建基础测试用例：
# tests/test_signature_generator.py
import unittest
import os
import sys
sys.path.append(os.path.join(os.path.dirname(__file__), '..'))from src.models.signature_data import SignatureData, ContactInfo, SocialPlatform
from src.models.validators import SignatureValidator
from src.generators.html_generator import HTMLSignatureGenerator
from src.generators.text_generator import TextSignatureGeneratorclass TestSignatureGenerator(unittest.TestCase):def setUp(self):"""测试前置设置"""self.contact = ContactInfo(phone="+86-10-12345678",email="test@example.com",website="https://www.example.com")self.signature_data = SignatureData(full_name="测试用户",job_title="测试工程师",company="测试公司",contact=self.contact)self.validator = SignatureValidator()self.html_generator = HTMLSignatureGenerator()self.text_generator = TextSignatureGenerator()def test_valid_signature_data(self):"""测试有效签名数据验证"""is_valid, errors = self.validator.validate_signature_data(self.signature_data)self.assertTrue(is_valid)self.assertEqual(len(errors), 0)def test_invalid_email(self):"""测试无效电子邮件验证"""self.signature_data.contact.email = "invalid-email"is_valid, errors = self.validator.validate_signature_data(self.signature_data)self.assertFalse(is_valid)self.assertIn('email', errors)def test_html_generation(self):"""测试HTML生成"""html_content = self.html_generator.generate_signature(self.signature_data)self.assertIsInstance(html_content, str)self.assertGreater(len(html_content), 0)self.assertIn('测试用户', html_content)self.assertIn('测试公司', html_content)def test_text_generation(self):"""测试纯文本生成"""text_content = self.text_generator.generate_signature(self.signature_data)self.assertIsInstance(text_content, str)self.assertGreater(len(text_content), 0)self.assertIn('测试用户', text_content)self.assertIn('测试公司', text_content)def test_social_media_addition(self):"""测试社交媒体添加"""initial_count = len(self.signature_data.social_media)self.signature_data.add_social_media(SocialPlatform.LINKEDIN, "https://linkedin.com/in/test")self.assertEqual(len(self.signature_data.social_media), initial_count + 1)def test_phone_formatting(self):"""测试电话号码格式化"""formatted = self.signature_data.contact.get_display_phone()self.assertIsNotNone(formatted)# 检查是否包含格式化的电话号码元素if __name__ == '__main__':unittest.main()
11. 部署和使用说明
11.1 安装和使用
- 安装依赖：
pip install -r requirements.txt
- 基本使用：
# 交互式创建签名
python -m src.cli create# 使用配置文件创建签名
python -m src.cli from-config config.json --output signature.html# 创建配置文件模板
python -m src.cli create-config --output my_config.json# 预览签名
python -m src.cli preview my_config.json
- 在Python代码中使用：
from src.models.signature_data import SignatureData, ContactInfo
from src.generators.html_generator import HTMLSignatureGenerator# 创建签名数据
contact = ContactInfo(email="user@example.com", phone="+1234567890")
data = SignatureData("张三", "工程师", "科技公司", contact=contact)# 生成HTML签名
generator = HTMLSignatureGenerator()
signature = generator.generate_signature(data)
11.2 最佳实践
-
图像优化：
- 使用小于200KB的图像文件
- 推荐使用PNG格式以获得更好的透明度支持
- 确保图像尺寸适当（建议100-200像素宽度）
-
颜色选择：
- 使用品牌颜色保持一致
- 确保足够的颜色对比度以便阅读
- 考虑色盲用户的体验
-
响应式设计：
- 测试在不同邮件客户端中的显示效果
- 使用表格布局确保兼容性
- 提供纯文本备用版本
-
可访问性：
- 为图像提供alt文本
- 使用语义化的HTML结构
- 确保键盘导航友好
12. 总结
本文详细介绍了一个完整的个性化电子邮件签名生成系统的设计和实现。通过这个系统，用户可以：
- 快速创建专业签名：通过简单的命令行界面或配置文件快速生成签名
- 多格式支持：同时生成HTML和纯文本格式，确保兼容性
- 高度可定制：支持多种主题风格、颜色配置和布局选项
- 数据验证：确保输入数据的有效性和一致性
- 社交媒体集成：轻松添加和管理社交媒体链接
这个系统的核心优势在于其灵活性和易用性。无论是个人用户还是企业管理员，都可以通过这个工具快速创建和维护专业的电子邮件签名，提升沟通的专业性和效率。
通过模块化的设计和良好的代码结构，这个系统还具有良好的可扩展性，可以轻松添加新的模板主题、输出格式或集成其他功能。