尧图网站建设 
简介这份网络交换机图例PPT学习教案面向网络技术初学者、网络工程专业学生及需要梳理基础设备的IT从业者借助图例形式帮助快速辨别不同交换机的定位与适用场景。课件共4页围绕通用交换机、核心交换机、分布层交换机、边缘接入交换机以及二层和三层交换机的转发差异展开并延伸到可插拔模块、堆叠部署、帧中继、X.25、存储程序控制交换系统等类型同时串联S8500、S3900、S3500、S3000、S2000、S1000、MA5200、S6500、S5000等型号及Hub、DSLAM、WAP、ISDN、Bridge、Office Connect hub、Baseline hub、DCEC、SUPSE等相关设备便于建立分层认知与选型思路。资源包共1个pptx文件大小约475KB内容轻量适合课堂演示或自学速览。目前已有133人学习能帮助读者在较短时间内理解交换机分类、网络层次与设备差异为后续配置和管理打基础也可据此整理分类笔记对照网络层次理解接入、分布、核心的职责边界。1. 网络交换机图例 PPT 学习教案先把“图例”当接口文档写给新同事讲交换机讲到堆叠和上联下面有人举手问“这个三角是什么”那一刻就知道前面二十分钟白讲了。问题不在听众在图例同一份网络交换机图例 PPT 学习教案里光口画成方框、电口也画成方框堆叠线用虚线、上联线也用虚线符号和含义之间没有锁定关系听众只能靠猜。图例不是排版装饰它是一份课的接口文档。一份能用的学习教案要求每个符号只表达一个含义并且在四五十页里不漂移RJ45 电口永远是同一个形状和颜色Console 口永远单独配色指示灯的颜色语义配一张对照表而不只是“绿的就正常”。做到这一点学员看拓扑页时才有认知锚点。适合做这件事的人比想象中多企业内训讲师、职业院校网络方向的老师、厂商售前以及那些天天被问“你画的这张图里这个方块是啥”的运维负责人。下面按符号体系、批量生成、真实组网标注、导出分发四条线把一份可复用的教案骨架讲清楚。2. 交换机图例的符号体系与教案素材规范2.1 端口、指示灯、堆叠口一套能讲清的图例分类图例分类的第一原则是按“学员需要据此做判断”来切而不是按设备面板上的物理排布来切。学员看到 RJ45 要知道这里能不能插网线、支持不支持千兆看到 SFP 要知道要配光模块和跳线看到堆叠口要知道这条线不是上联插错会成环。分类的粒度应该刚好落在这些判断点上多一层是负担少一层就是歧义。我一般把交换机图例拆成六类电口、光口、Console/管理口、堆叠口、PoE 口、状态指示灯。前五类是“接口”最后一类是“状态”两类画法逻辑不同——接口用固定形状加文字码指示灯用颜色加闪烁频率千万别把指示灯也画成小方块塞进端口行里。图例元素推荐画法常见错误千兆电口 RJ45圆角矩形 文字码 GE与百兆口用同一形状只在文字上区分光口 SFP/SFP矩形加两侧短斜线 文字码 SFP与电口同形学员分不清介质Console 管理口单独配色如橙色 文字码 CON混在业务口行里被当作可上联口堆叠口双向粗箭头 文字码 STK用上联链路的线型逻辑层直接画错PoE 供电口端口形状右上角叠加闪电符号用红色表示 PoE与告警色冲突状态指示灯圆形 颜色 闪烁频率说明只写颜色不写“常亮/闪烁”对应含义上行链路加粗实线与接入链路区分色上联与堆叠共用线型拓扑讲解时崩掉颜色数量必须克制。一套教案里主色不超过四种剩下的靠形状和文字码区分。原因很现实投影仪偏色、学员手机拍屏幕、打印成灰度讲义这三种场景下颜色的区分度都会掉只有形状是稳的。2.2 用母版和主题文件把视觉一次定死符号定义好了下一个坑是“这一页是我画完的下一页是同事贴的”。解决办法是把图例规格沉到幻灯片母版和主题文件里而不是每页手工对齐。PowerPoint 里通过“视图 → 幻灯片母版”改版式通过“设计 → 主题 → 保存当前主题”产出 .thmx 文件整套配色、字体、占位符尺寸就固化了。改完先别急着分发验证一下字体到底有没有真的写进文件里。pptx 本质是个 zip 包直接解压看主题里的 typeface 声明比在界面上凭感觉点要可靠# 校验一份教案里实际使用了哪些字体避免换电脑后方框乱码 mkdir -p /tmp/ppt_check cp 网络交换机图例PPT学习教案.pptx /tmp/ppt_check/ cd /tmp/ppt_check unzip -o -q 网络交换机图例PPT学习教案.pptx -d unpacked grep -oh typeface[^]* unpacked/ppt/slides/*.xml unpacked/ppt/theme/*.xml \ | sort | uniq -c | sort -rn这段命令做三件事解压 pptx、从所有幻灯片和主题 XML 里抓 typeface 属性、按出现次数排序。输出的第一位通常就是你实际在用的中文字体比如“微软雅黑”。如果结果里出现了“mn-lt”“mj-ea”这类占位符说明这一页用的是主题字体而不是显式字体换到没装该主题字体的机器上就会变形。此时要么把主题里的大纲字体改掉要么给关键文本框显式指定字体。提示母版改完只影响新建页已经手工画好的旧页不会自动跟随。先把旧页的形状复制到新版式占位符里比逐页调位置快得多。2.3 素材来源路由器和交换机搭建网络的图片怎么选不踩雷教案里的拓扑配图有两个来源自己画和设备厂商公开的产品图。自己画的图变现性好、可控缺点是慢厂商图好看但配色和你的图例体系往往打架。我一般只借用产品外观图放在“设备认知”那一页一到拓扑层就切回自己的图例避免两套视觉语言混在一份教案里。搜图时容易踩的雷是“图好看但画错了”。常见的错误画法包括把交换机的上联口画成直连 PC、把两台交换机的堆叠线画成普通网线、把路由器的 LAN 口和交换机的上行口画成同一种线。一旦这些图进了教案学员会把错误画法当标准记住后期纠偏的成本远高于当初自己画一张。判断标准很简单图上每一根线你都能说出它的两端端口类型和速率。3. 用 python-pptx 批量生成网络交换机图例教案页3.1 环境准备与最小可跑命令当图例数量上到二三十个手工摆形状就不划算了。用 python-pptx 把图例数据和排版逻辑分离改内容只改数据不用碰坐标。装依赖、跑脚本两条命令python -m pip install python-pptx python build_switch_legend.py # 生成 网络交换机图例-教案页.pptx脚本输出的是一页“图例总览页”左侧按网格排图形右侧放参数对照表并把讲解词写进备注。母版、配色、字体在界面上事先定好脚本只负责往里灌内容这样生成出来的页面和手工页视觉一致。3.2 代码一页标准图例页加参数表# build_switch_legend.py from pptx import Presentation from pptx.util import Cm, Pt from pptx.dml.color import RGBColor from pptx.enum.shapes import MSO_SHAPE from pptx.oxml.ns import qn # 图例数据与排版分离换一套设备只改这个列表 LEGEND [ {code: GE, name: 千兆电口 RJ45, note: 自协商 10/100/1000M讲协商话题的主场}, {code: SFP, name: 光口 SFP/SFP, note: 需标注模块型号、波长、跳线类型}, {code: CON, name: Console 管理口, note: 单独配色强调不能当业务口用}, {code: STK, name: 堆叠口, note: 双向粗箭头与上联链路严格区分}, {code: PoE, name: PoE 供电口, note: 端口符号叠加闪电标注单口功率预算}, {code: LED, name: 状态指示灯, note: 颜色 常亮/闪烁两层语义}, ] # 接口类用蓝色管理类用橙色状态类用灰色 FILL {CON: B24A1F, LED: 7F7F7F} DEFAULT_FILL 1F6FB2 def set_font(run, size14, boldFalse, name微软雅黑, colorNone): 统一设置字号/粗体/字体并补上中文字形east asian声明 f run.font f.size, f.bold, f.name Pt(size), bold, name if color: f.color.rgb RGBColor.from_string(color) rPr f._rPr # 内部 API用来补 a:ea 节点 ea rPr.find(qn(a:ea)) if ea is None: ea rPr.makeelement(qn(a:ea), {}) rPr.append(ea) ea.set(typeface, name) def draw_legend_items(slide, items, topCm(2.6)): 按两列网格摆放图例符号每个符号底下挂文字码 cell_w, cell_h Cm(4.2), Cm(2.6) for i, it in enumerate(items): col, row i % 6, i // 6 left, top_i Cm(1.5) col * cell_w, top row * cell_h shape slide.shapes.add_shape( MSO_SHAPE.ROUNDED_RECTANGLE, left, top_i, Cm(3.4), Cm(1.6)) shape.fill.solid() shape.fill.fore_color.rgb RGBColor.from_string( FILL.get(it[code], DEFAULT_FILL)) shape.line.color.rgb RGBColor.from_string(FFFFFF) tf shape.text_frame tf.text it[code] set_font(tf.paragraphs[0].runs[0], size16, boldTrue, colorFFFFFF) def add_table(slide, items, topCm(9.6)): 把图例语义写成对照表课堂上比图形更好抄 rows, cols len(items) 1, 3 tbl slide.shapes.add_table( rows, cols, Cm(1.5), top, Cm(30), Cm(8)).table for idx, width in enumerate((Cm(4), Cm(9), Cm(17))): tbl.columns[idx].width width for c, text in enumerate((文字码, 图例名称, 标注要点)): cell tbl.cell(0, c) cell.text text set_font(cell.text_frame.paragraphs[0].runs[0], size14, boldTrue) for r, it in enumerate(items, start1): for c, key in enumerate((code, name, note)): cell tbl.cell(r, c) cell.text it[key] set_font(cell.text_frame.paragraphs[0].runs[0], size12) def main(): prs Presentation() prs.slide_width, prs.slide_height Cm(33.87), Cm(19.05) # 16:9 slide prs.slides.add_slide(prs.slide_layouts[6]) # 6 空白版式 title slide.shapes.add_textbox(Cm(1.5), Cm(0.8), Cm(30), Cm(1.4)) run title.text_frame.paragraphs[0].add_run() run.text 网络交换机图例总览符号、文字码与标注要点 set_font(run, size28, boldTrue) draw_legend_items(slide, LEGEND) add_table(slide, LEGEND) # 讲解词写进备注演示者视图直接看不占正文版面 notes slide.notes_slide.notes_text_frame notes.text 先讲文字码规则所有端口符号必须带码。再讲颜色只用于区分接口/管理/状态三类。 prs.save(网络交换机图例-教案页.pptx) if __name__ __main__: main()逻辑上是三段LEGEND存数据draw_legend_items负责符号网格add_table负责语义对照表main负责页面尺寸、版式和备注。改设备型号时只动LEGEND坐标一行都不用改——这也是把教案做成脚本而不是纯手工的根本理由。参数上有几个点值得单独说。prs.slide_width用Cm(33.87)对应 16:9 宽屏数值来自 13.333 英寸换算写成Cm(25.4)会退回到 4:3。prs.slide_layouts[6]是默认模板里的空白版式用带占位符的版式会被母版里的占位框挤位置初学阶段直接用空白版式最省事。Cm和Pt是两套单位形状坐标用Cm、字号用Pt混用会导致元素跑到画布外。3.3 中文字体与常见报错最典型的报错不是异常而是“代码跑通了打开一看全是方框”。原因是run.font.name只写了a:latin节点中文走的是a:ea没声明就退回默认字体在没装该字体的机器上直接方框化。set_font里补a:ea就是干这件事。第二类问题是字体缺失。在 Linux 或容器里生成 PPT宿主机往往没有中文字体生成后到 Windows 上打开会提示替换字体。装一套开源中文字体例如fonts-noto-cjk能解决渲染侧的问题但更稳的做法是母版里就用通用字体族别依赖某台机器上的私有字体。第三类是表格溢出。add_table里给的Cm(8)高度是行高总和的上限行数超过八行时会被压扁成蚂蚁字。二三十个图例不要塞一页按“电口与光口”“管理口与堆叠”“PoE 与指示灯”拆成三页每页控制在八行以内rows参数自然就下来了。注意font._rPr属于 python-pptx 的内部属性跨大版本升级时可能改名。真遇到取不到的情况退路是在母版里把中文和西文字体都设好脚本里只设字号效果等价。4. 从图例到真实组网拓扑页与参数标注怎么写进教案4.1 三层结构物理图例层、逻辑链路层、参数表拓扑页最容易犯的错是把三个层次压在一张图上设备外观、接口关系、IP 与 VLAN 全糊在一起。学员看第一眼就放弃了。我一般拆成三层同页或连续三页呈现。物理层只放图例符号和端口文字码说明“线插在哪”逻辑层把设备抽象成矩形只画链路和协议说明“数据怎么走”参数表承载 IP 段、VLAN ID、链路速率和双工模式说明“配什么值”。参数表的列建议固定成五列跨章节保持一致学员的阅读成本会明显下降链路编号两端设备与端口介质与速率双工关键配置L1SW1 GE0/0/24 — SW2 GE0/0/24超五类1000M全双工静态链路聚合L2SW1 STK — SW2 STK堆叠线缆—堆叠优先级 100L3SW1 SFP1 — 核心 SFP3单模10G全双工允许 VLAN 10/20 通过L4SW1 CON — 管理终端串口线9600-8-N-1仅开局调试使用这张表还有一个隐藏作用它逼你在画图前就把端口号定下来。手工画图时常见的“先随便画配的时候再说”最后一定会导致图上标着 GE0/0/24、配置里写的是 GE0/0/23学员照抄就报错。4.2 案例千兆口只协商到 10M教案里应该怎么画有个在学员群里高频出现的现象全千兆路由器接到千兆交换机上某个口只协商到 10M。这个案例特别适合放进图例教案因为它把“图例标注”和“现场排错”接上了。教案里做三件事把协商速率写进端口符号的悬停说明、给出排查命令、给出判断分支。# 华为/华三查看端口当前协商结果与错包计数 display interface GigabitEthernet 0/0/1 | include (current state|Bandwidth|duplex|errors) # 思科一眼看速率与双工 show interfaces GigabitEthernet1/0/1 status show interfaces GigabitEthernet1/0/1 | include (rate|duplex|CRC) # Linux 主机侧确认网卡与对端协商结果 ethtool eth0 | grep -E Speed|Duplex|Auto-negotiation命令看的是三件事当前速率与双工、是否开启了自协商、有没有 CRC 或错包增长。三者组合起来给结论。自协商开着但速率只有 10M通常是线序或水晶头接触不良网线只跑通了部分线对速率正常但有大量 CRC问题在介质质量两边双工一边全双工一边半双工那是手工写死了配置的典型后果。教案里对应的图例规范是凡是被写入参数表的链路符号旁边必须跟一个速率标记10M/100M/1000M/10G 用统一的角标表示。不要用颜色深浅表示速率那和前面“颜色只表达接口类别”的规则冲突。学员排错时看的第一个东西就是速率角标图上没有就得回去翻配置。4.3 练习页与答案页把答案写进备注教案不能只有正面示例得有让学员自己画的环节。做法是准备一组“空白拓扑页”只画设备框和端口文字码连线留空让学员按需求描述连线。答案不要另建一份文件直接写在备注里——演示者视图能看投影看不到也不会出现“答案页误投”的尴尬。python-pptx 生成练习题页时只要把要隐藏的答案文本写进notes_slide.notes_text_frame正文里留空即可。这个思路同样适用于代码题、配置题。练习页的字号可以比正文大一档因为学员要看清楚端口文字码答案页文字多字号小一档反正是给讲师看的。5. 导出、加密与课堂分发的几个进阶手法学员要讲义第一反应是导出 PDF。这里有个高频问题PNG 截图塞进 PPT 再导 PDF图会糊。根源在没有走矢量路径。正确做法是图形本身用 PPT 原生形状原生形状导出 PDF 时保留矢量位图用“另存为 → PDF”而不是截图或者把“另存为 → 图片 → 每张幻灯片”的分辨率提到 300 DPI。分辨率要改注册表才能生效路径是HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\PowerPoint\Options新建 DWORD 值ExportBitmapResolution十进制填 300。改完重启 PowerPoint导出图片就是 300 DPI投影和打印都够用。低于 150 DPI 时拓扑图上的端口文字码会糊成一团学员抄不下来。分发场景推荐格式注意点课堂投影.pptx 原件关闭自动播放保留备注供演示者视图学员讲义.pdf矢量优先位图页单独提 300 DPI 再合并线上自学.mp4备注转语音录制时勾选“使用录制的计时和旁白”只读分发.pptx 修改密码密码只防误改不承担保密责任备注转语音这条路值得单独讲。很多讲师的备注里写的是完整讲稿直接“文件 → 导出 → 创建视频”在弹窗里勾上“使用录制的计时和旁白”就能把备注按录制顺序念出来省掉重新配音的工夫。前提是备注写的是成句的讲稿而不是“这里强调一下”这种给自己看的提示所以教案写作时备注要一次到位。关于自动生成课件的工具有一条硬约束涉及内部网络拓扑和端口规划的材料不能上传到外部服务。可行的路径是把模型跑在本地或内网只让它输出一份结构化 JSON每页的标题、要点、图例清单再用前面那套 python-pptx 脚本渲染成页。这样模型负责文字脚本负责排版图例体系仍然由你那套母版控制不会出现模型自创一套符号、把整份教案的视觉规则冲掉的情况。最后一招是加密与留痕。给文件加“打开密码”和“修改密码”时注意修改密码只防误改能打开的机器就能另存真要控分发范围靠的是分发渠道而不是文件本身。更实用的是留一处版本标记在母版页脚放一个小的版本号和日期文本框学员问“我这份是不是最新的”看页脚就够。本文还有配套的精品资源点击获取 网络交换机图例PPT教案：符号规范与python-pptx批量生成
简介这份网络交换机图例PPT学习教案面向网络技术初学者、网络工程专业学生及需要梳理基础设备的IT从业者借助图例形式帮助快速辨别不同交换机的定位与适用场景。课件共4页围绕通用交换机、核心交换机、分布层交换机、边缘接入交换机以及二层和三层交换机的转发差异展开并延伸到可插拔模块、堆叠部署、帧中继、X.25、存储程序控制交换系统等类型同时串联S8500、S3900、S3500、S3000、S2000、S1000、MA5200、S6500、S5000等型号及Hub、DSLAM、WAP、ISDN、Bridge、Office Connect hub、Baseline hub、DCEC、SUPSE等相关设备便于建立分层认知与选型思路。资源包共1个pptx文件大小约475KB内容轻量适合课堂演示或自学速览。目前已有133人学习能帮助读者在较短时间内理解交换机分类、网络层次与设备差异为后续配置和管理打基础也可据此整理分类笔记对照网络层次理解接入、分布、核心的职责边界。1. 网络交换机图例 PPT 学习教案先把“图例”当接口文档写给新同事讲交换机讲到堆叠和上联下面有人举手问“这个三角是什么”那一刻就知道前面二十分钟白讲了。问题不在听众在图例同一份网络交换机图例 PPT 学习教案里光口画成方框、电口也画成方框堆叠线用虚线、上联线也用虚线符号和含义之间没有锁定关系听众只能靠猜。图例不是排版装饰它是一份课的接口文档。一份能用的学习教案要求每个符号只表达一个含义并且在四五十页里不漂移RJ45 电口永远是同一个形状和颜色Console 口永远单独配色指示灯的颜色语义配一张对照表而不只是“绿的就正常”。做到这一点学员看拓扑页时才有认知锚点。适合做这件事的人比想象中多企业内训讲师、职业院校网络方向的老师、厂商售前以及那些天天被问“你画的这张图里这个方块是啥”的运维负责人。下面按符号体系、批量生成、真实组网标注、导出分发四条线把一份可复用的教案骨架讲清楚。2. 交换机图例的符号体系与教案素材规范2.1 端口、指示灯、堆叠口一套能讲清的图例分类图例分类的第一原则是按“学员需要据此做判断”来切而不是按设备面板上的物理排布来切。学员看到 RJ45 要知道这里能不能插网线、支持不支持千兆看到 SFP 要知道要配光模块和跳线看到堆叠口要知道这条线不是上联插错会成环。分类的粒度应该刚好落在这些判断点上多一层是负担少一层就是歧义。我一般把交换机图例拆成六类电口、光口、Console/管理口、堆叠口、PoE 口、状态指示灯。前五类是“接口”最后一类是“状态”两类画法逻辑不同——接口用固定形状加文字码指示灯用颜色加闪烁频率千万别把指示灯也画成小方块塞进端口行里。图例元素推荐画法常见错误千兆电口 RJ45圆角矩形 文字码 GE与百兆口用同一形状只在文字上区分光口 SFP/SFP矩形加两侧短斜线 文字码 SFP与电口同形学员分不清介质Console 管理口单独配色如橙色 文字码 CON混在业务口行里被当作可上联口堆叠口双向粗箭头 文字码 STK用上联链路的线型逻辑层直接画错PoE 供电口端口形状右上角叠加闪电符号用红色表示 PoE与告警色冲突状态指示灯圆形 颜色 闪烁频率说明只写颜色不写“常亮/闪烁”对应含义上行链路加粗实线与接入链路区分色上联与堆叠共用线型拓扑讲解时崩掉颜色数量必须克制。一套教案里主色不超过四种剩下的靠形状和文字码区分。原因很现实投影仪偏色、学员手机拍屏幕、打印成灰度讲义这三种场景下颜色的区分度都会掉只有形状是稳的。2.2 用母版和主题文件把视觉一次定死符号定义好了下一个坑是“这一页是我画完的下一页是同事贴的”。解决办法是把图例规格沉到幻灯片母版和主题文件里而不是每页手工对齐。PowerPoint 里通过“视图 → 幻灯片母版”改版式通过“设计 → 主题 → 保存当前主题”产出 .thmx 文件整套配色、字体、占位符尺寸就固化了。改完先别急着分发验证一下字体到底有没有真的写进文件里。pptx 本质是个 zip 包直接解压看主题里的 typeface 声明比在界面上凭感觉点要可靠# 校验一份教案里实际使用了哪些字体避免换电脑后方框乱码 mkdir -p /tmp/ppt_check cp 网络交换机图例PPT学习教案.pptx /tmp/ppt_check/ cd /tmp/ppt_check unzip -o -q 网络交换机图例PPT学习教案.pptx -d unpacked grep -oh typeface[^]* unpacked/ppt/slides/*.xml unpacked/ppt/theme/*.xml \ | sort | uniq -c | sort -rn这段命令做三件事解压 pptx、从所有幻灯片和主题 XML 里抓 typeface 属性、按出现次数排序。输出的第一位通常就是你实际在用的中文字体比如“微软雅黑”。如果结果里出现了“mn-lt”“mj-ea”这类占位符说明这一页用的是主题字体而不是显式字体换到没装该主题字体的机器上就会变形。此时要么把主题里的大纲字体改掉要么给关键文本框显式指定字体。提示母版改完只影响新建页已经手工画好的旧页不会自动跟随。先把旧页的形状复制到新版式占位符里比逐页调位置快得多。2.3 素材来源路由器和交换机搭建网络的图片怎么选不踩雷教案里的拓扑配图有两个来源自己画和设备厂商公开的产品图。自己画的图变现性好、可控缺点是慢厂商图好看但配色和你的图例体系往往打架。我一般只借用产品外观图放在“设备认知”那一页一到拓扑层就切回自己的图例避免两套视觉语言混在一份教案里。搜图时容易踩的雷是“图好看但画错了”。常见的错误画法包括把交换机的上联口画成直连 PC、把两台交换机的堆叠线画成普通网线、把路由器的 LAN 口和交换机的上行口画成同一种线。一旦这些图进了教案学员会把错误画法当标准记住后期纠偏的成本远高于当初自己画一张。判断标准很简单图上每一根线你都能说出它的两端端口类型和速率。3. 用 python-pptx 批量生成网络交换机图例教案页3.1 环境准备与最小可跑命令当图例数量上到二三十个手工摆形状就不划算了。用 python-pptx 把图例数据和排版逻辑分离改内容只改数据不用碰坐标。装依赖、跑脚本两条命令python -m pip install python-pptx python build_switch_legend.py # 生成 网络交换机图例-教案页.pptx脚本输出的是一页“图例总览页”左侧按网格排图形右侧放参数对照表并把讲解词写进备注。母版、配色、字体在界面上事先定好脚本只负责往里灌内容这样生成出来的页面和手工页视觉一致。3.2 代码一页标准图例页加参数表# build_switch_legend.py from pptx import Presentation from pptx.util import Cm, Pt from pptx.dml.color import RGBColor from pptx.enum.shapes import MSO_SHAPE from pptx.oxml.ns import qn # 图例数据与排版分离换一套设备只改这个列表 LEGEND [ {code: GE, name: 千兆电口 RJ45, note: 自协商 10/100/1000M讲协商话题的主场}, {code: SFP, name: 光口 SFP/SFP, note: 需标注模块型号、波长、跳线类型}, {code: CON, name: Console 管理口, note: 单独配色强调不能当业务口用}, {code: STK, name: 堆叠口, note: 双向粗箭头与上联链路严格区分}, {code: PoE, name: PoE 供电口, note: 端口符号叠加闪电标注单口功率预算}, {code: LED, name: 状态指示灯, note: 颜色 常亮/闪烁两层语义}, ] # 接口类用蓝色管理类用橙色状态类用灰色 FILL {CON: B24A1F, LED: 7F7F7F} DEFAULT_FILL 1F6FB2 def set_font(run, size14, boldFalse, name微软雅黑, colorNone): 统一设置字号/粗体/字体并补上中文字形east asian声明 f run.font f.size, f.bold, f.name Pt(size), bold, name if color: f.color.rgb RGBColor.from_string(color) rPr f._rPr # 内部 API用来补 a:ea 节点 ea rPr.find(qn(a:ea)) if ea is None: ea rPr.makeelement(qn(a:ea), {}) rPr.append(ea) ea.set(typeface, name) def draw_legend_items(slide, items, topCm(2.6)): 按两列网格摆放图例符号每个符号底下挂文字码 cell_w, cell_h Cm(4.2), Cm(2.6) for i, it in enumerate(items): col, row i % 6, i // 6 left, top_i Cm(1.5) col * cell_w, top row * cell_h shape slide.shapes.add_shape( MSO_SHAPE.ROUNDED_RECTANGLE, left, top_i, Cm(3.4), Cm(1.6)) shape.fill.solid() shape.fill.fore_color.rgb RGBColor.from_string( FILL.get(it[code], DEFAULT_FILL)) shape.line.color.rgb RGBColor.from_string(FFFFFF) tf shape.text_frame tf.text it[code] set_font(tf.paragraphs[0].runs[0], size16, boldTrue, colorFFFFFF) def add_table(slide, items, topCm(9.6)): 把图例语义写成对照表课堂上比图形更好抄 rows, cols len(items) 1, 3 tbl slide.shapes.add_table( rows, cols, Cm(1.5), top, Cm(30), Cm(8)).table for idx, width in enumerate((Cm(4), Cm(9), Cm(17))): tbl.columns[idx].width width for c, text in enumerate((文字码, 图例名称, 标注要点)): cell tbl.cell(0, c) cell.text text set_font(cell.text_frame.paragraphs[0].runs[0], size14, boldTrue) for r, it in enumerate(items, start1): for c, key in enumerate((code, name, note)): cell tbl.cell(r, c) cell.text it[key] set_font(cell.text_frame.paragraphs[0].runs[0], size12) def main(): prs Presentation() prs.slide_width, prs.slide_height Cm(33.87), Cm(19.05) # 16:9 slide prs.slides.add_slide(prs.slide_layouts[6]) # 6 空白版式 title slide.shapes.add_textbox(Cm(1.5), Cm(0.8), Cm(30), Cm(1.4)) run title.text_frame.paragraphs[0].add_run() run.text 网络交换机图例总览符号、文字码与标注要点 set_font(run, size28, boldTrue) draw_legend_items(slide, LEGEND) add_table(slide, LEGEND) # 讲解词写进备注演示者视图直接看不占正文版面 notes slide.notes_slide.notes_text_frame notes.text 先讲文字码规则所有端口符号必须带码。再讲颜色只用于区分接口/管理/状态三类。 prs.save(网络交换机图例-教案页.pptx) if __name__ __main__: main()逻辑上是三段LEGEND存数据draw_legend_items负责符号网格add_table负责语义对照表main负责页面尺寸、版式和备注。改设备型号时只动LEGEND坐标一行都不用改——这也是把教案做成脚本而不是纯手工的根本理由。参数上有几个点值得单独说。prs.slide_width用Cm(33.87)对应 16:9 宽屏数值来自 13.333 英寸换算写成Cm(25.4)会退回到 4:3。prs.slide_layouts[6]是默认模板里的空白版式用带占位符的版式会被母版里的占位框挤位置初学阶段直接用空白版式最省事。Cm和Pt是两套单位形状坐标用Cm、字号用Pt混用会导致元素跑到画布外。3.3 中文字体与常见报错最典型的报错不是异常而是“代码跑通了打开一看全是方框”。原因是run.font.name只写了a:latin节点中文走的是a:ea没声明就退回默认字体在没装该字体的机器上直接方框化。set_font里补a:ea就是干这件事。第二类问题是字体缺失。在 Linux 或容器里生成 PPT宿主机往往没有中文字体生成后到 Windows 上打开会提示替换字体。装一套开源中文字体例如fonts-noto-cjk能解决渲染侧的问题但更稳的做法是母版里就用通用字体族别依赖某台机器上的私有字体。第三类是表格溢出。add_table里给的Cm(8)高度是行高总和的上限行数超过八行时会被压扁成蚂蚁字。二三十个图例不要塞一页按“电口与光口”“管理口与堆叠”“PoE 与指示灯”拆成三页每页控制在八行以内rows参数自然就下来了。注意font._rPr属于 python-pptx 的内部属性跨大版本升级时可能改名。真遇到取不到的情况退路是在母版里把中文和西文字体都设好脚本里只设字号效果等价。4. 从图例到真实组网拓扑页与参数标注怎么写进教案4.1 三层结构物理图例层、逻辑链路层、参数表拓扑页最容易犯的错是把三个层次压在一张图上设备外观、接口关系、IP 与 VLAN 全糊在一起。学员看第一眼就放弃了。我一般拆成三层同页或连续三页呈现。物理层只放图例符号和端口文字码说明“线插在哪”逻辑层把设备抽象成矩形只画链路和协议说明“数据怎么走”参数表承载 IP 段、VLAN ID、链路速率和双工模式说明“配什么值”。参数表的列建议固定成五列跨章节保持一致学员的阅读成本会明显下降链路编号两端设备与端口介质与速率双工关键配置L1SW1 GE0/0/24 — SW2 GE0/0/24超五类1000M全双工静态链路聚合L2SW1 STK — SW2 STK堆叠线缆—堆叠优先级 100L3SW1 SFP1 — 核心 SFP3单模10G全双工允许 VLAN 10/20 通过L4SW1 CON — 管理终端串口线9600-8-N-1仅开局调试使用这张表还有一个隐藏作用它逼你在画图前就把端口号定下来。手工画图时常见的“先随便画配的时候再说”最后一定会导致图上标着 GE0/0/24、配置里写的是 GE0/0/23学员照抄就报错。4.2 案例千兆口只协商到 10M教案里应该怎么画有个在学员群里高频出现的现象全千兆路由器接到千兆交换机上某个口只协商到 10M。这个案例特别适合放进图例教案因为它把“图例标注”和“现场排错”接上了。教案里做三件事把协商速率写进端口符号的悬停说明、给出排查命令、给出判断分支。# 华为/华三查看端口当前协商结果与错包计数 display interface GigabitEthernet 0/0/1 | include (current state|Bandwidth|duplex|errors) # 思科一眼看速率与双工 show interfaces GigabitEthernet1/0/1 status show interfaces GigabitEthernet1/0/1 | include (rate|duplex|CRC) # Linux 主机侧确认网卡与对端协商结果 ethtool eth0 | grep -E Speed|Duplex|Auto-negotiation命令看的是三件事当前速率与双工、是否开启了自协商、有没有 CRC 或错包增长。三者组合起来给结论。自协商开着但速率只有 10M通常是线序或水晶头接触不良网线只跑通了部分线对速率正常但有大量 CRC问题在介质质量两边双工一边全双工一边半双工那是手工写死了配置的典型后果。教案里对应的图例规范是凡是被写入参数表的链路符号旁边必须跟一个速率标记10M/100M/1000M/10G 用统一的角标表示。不要用颜色深浅表示速率那和前面“颜色只表达接口类别”的规则冲突。学员排错时看的第一个东西就是速率角标图上没有就得回去翻配置。4.3 练习页与答案页把答案写进备注教案不能只有正面示例得有让学员自己画的环节。做法是准备一组“空白拓扑页”只画设备框和端口文字码连线留空让学员按需求描述连线。答案不要另建一份文件直接写在备注里——演示者视图能看投影看不到也不会出现“答案页误投”的尴尬。python-pptx 生成练习题页时只要把要隐藏的答案文本写进notes_slide.notes_text_frame正文里留空即可。这个思路同样适用于代码题、配置题。练习页的字号可以比正文大一档因为学员要看清楚端口文字码答案页文字多字号小一档反正是给讲师看的。5. 导出、加密与课堂分发的几个进阶手法学员要讲义第一反应是导出 PDF。这里有个高频问题PNG 截图塞进 PPT 再导 PDF图会糊。根源在没有走矢量路径。正确做法是图形本身用 PPT 原生形状原生形状导出 PDF 时保留矢量位图用“另存为 → PDF”而不是截图或者把“另存为 → 图片 → 每张幻灯片”的分辨率提到 300 DPI。分辨率要改注册表才能生效路径是HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\PowerPoint\Options新建 DWORD 值ExportBitmapResolution十进制填 300。改完重启 PowerPoint导出图片就是 300 DPI投影和打印都够用。低于 150 DPI 时拓扑图上的端口文字码会糊成一团学员抄不下来。分发场景推荐格式注意点课堂投影.pptx 原件关闭自动播放保留备注供演示者视图学员讲义.pdf矢量优先位图页单独提 300 DPI 再合并线上自学.mp4备注转语音录制时勾选“使用录制的计时和旁白”只读分发.pptx 修改密码密码只防误改不承担保密责任备注转语音这条路值得单独讲。很多讲师的备注里写的是完整讲稿直接“文件 → 导出 → 创建视频”在弹窗里勾上“使用录制的计时和旁白”就能把备注按录制顺序念出来省掉重新配音的工夫。前提是备注写的是成句的讲稿而不是“这里强调一下”这种给自己看的提示所以教案写作时备注要一次到位。关于自动生成课件的工具有一条硬约束涉及内部网络拓扑和端口规划的材料不能上传到外部服务。可行的路径是把模型跑在本地或内网只让它输出一份结构化 JSON每页的标题、要点、图例清单再用前面那套 python-pptx 脚本渲染成页。这样模型负责文字脚本负责排版图例体系仍然由你那套母版控制不会出现模型自创一套符号、把整份教案的视觉规则冲掉的情况。最后一招是加密与留痕。给文件加“打开密码”和“修改密码”时注意修改密码只防误改能打开的机器就能另存真要控分发范围靠的是分发渠道而不是文件本身。更实用的是留一处版本标记在母版页脚放一个小的版本号和日期文本框学员问“我这份是不是最新的”看页脚就够。本文还有配套的精品资源点击获取