11

我应该就我评估过的 Web 框架为我的同事做一个演示。这些人是开发人员，讨厌冗长乏味的 PowerPoint 内容，所以我得到了很多小代码片段。我还整理了一个小型示例应用程序。我的问题是，我如何呈现代码以便人们可以遵循？

我想到的一些事情：

  • 将代码放在 PowerPoint 幻灯片上，看起来很糟糕，除非它是图像，否则我无法让语法突出显示工作。将我的代码放在图像中很痛苦，并且不能很好地扩展到不同的分辨率。
  • 我使用了 S5 XHTML 演示格式并集成了一个 JavaScript 语法高亮显示。这有点笨拙但可行（我会因为忽略公司的 CI 进行演示而感到悲伤，因为我不会使用他们的模板。甚至不要问......）
  • 我可以在我的观众面前整理一个脚本（笔记）和“实时代码”。我不太喜欢这个，因为它让我很忙，以至于我在写作时很难给出一个好的解释。而且我也很有可能导致错误并让他们等待。
  • 截屏？但那样我就不必在那里了……也许叙述一下？

那你会怎么做？

4

8 回答 8

5

我可以在我的观众面前编写一个脚本和“实时代码”。我不太喜欢这个，因为它让我很忙，以至于我在写作时很难给出一个好的解释。而且我也很有可能导致错误并让他们等待。

我喜欢这个选项，如果你能把你的演示精简到不妨碍观众的地步。当食谱花费的时间超过他们的时间时，您可以做电视厨师所做的事情；开始编码，然后跳到已完成 90% 或 100% 的代码。

如果你有一个同事，你可以跟上进度，你可以让他们在你说话的同时进行编码并指出他们在做什么。

您可以使用您的 IDE，它会突出显示语法并向您的听众展示如何编译、部署、测试等。不过，我建议您使用超大字体，仅用于会话，以便每个人都能看到。

于 2009-01-17T23:52:04.930 回答
1

您的 IDE 是否允许打开/关闭区域或代码段？在 Visual Studio 中，您可以创建可以展开或折叠的代码区域。如果您的 IDE 能够执行此操作，您可以将代码示例创建为区域，然后在您浏览演示文稿时打开/关闭它们。您可以在 IDE 中的演示文稿和代码示例之间来回切换，但不必即时编写代码。使用 open/close 可以让你隐藏你没有引用的代码，以减少混乱。

实际上，我在 Agile 2008 上看到了这一点，它似乎工作得很好。

于 2009-01-17T23:51:35.510 回答
1

您只能在 PowerPoint 幻灯片上放置这么多信息，但这实际上是一件好事：人们只能查看一定数量的信息并从中获得有意义的信息。

因此，如果您无法将其放在 PowerPoint 幻灯片上，您需要重新考虑您的方法。

代码片段很好。它们不需要突出显示。只需将它们放入 Courier New（或其他一些固定宽度的字体），它就会作为代码出现。代码片段也不必完整。只需将它们归结为基本概念（使用注释或省略号表示缺少的代码）。

程序员作为程序员，他们可能会在涉及技术时提出问题，这很好。

此外，如果程序员熟悉类似的东西，请尝试将所有概念与他们所知道的联系起来。它使它更容易掌握。就像您在解释 Spring MVC 并且他们知道 Struts 一样，请解释 Struts 等价物。将这类东西放在表格中（甚至作为讲义）会很有用。

这正是我所做的（Struts 程序员的 Spring MVC 入门）。

于 2009-01-17T23:52:33.213 回答
1

如果您希望您的观众看到很多代码片段，尤其是冗长的代码片段，您可以将它们打印为讲义，或者以 PDF 或文本文件的形式提供它们（人们可以在他们的笔记本电脑上跟进）。

实际的演示幻灯片应包含传达您的想法所需的最少文本（包括代码）。如果从远处阅读很多内容，您的听众会在一段时间后感到疲倦，并且可能难以跟上。让人们在自己的笔记本电脑或讲义上阅读完整的代码部分，同时只关注演示幻灯片或脚本中的关键部分。

于 2009-01-18T00:01:59.480 回答
0

如果他们不喜欢 Powerpoint，请不要使用它。我们使用 Camtasia 屏幕录制来录制“现场”演示以向客户演示（使用引号直播，因为它没有在演示过程中崩溃的缺点:-)。他们总是更喜欢看到它在行动，而不是他们认为是捏造的功能。

它像您的 Powerpoint 幻灯片一样可以暂停，并且具有语法着色的优势，因为您只需在您最喜欢的编辑器中记录您的想法。它也是动态的，比 Powerpoint 好得多（尽管我见过一些人用多张 Powerpoint 幻灯片制作粗略的动画，在实际中观看总是很有趣）。

这基本上与您的截屏想法相对应，但是，如果您想要一个在那里的理由，请制作大量的小截屏以显示穿插在您的真实演示文稿之间，如有必要，进行叙述（亲自，而不是在截屏上）。

就个人而言，我更愿意向目标受众发送一个完整叙述的 Camtasia，但那是因为我还没有完全摆脱我职业生涯早期的公开演讲恐惧症 :-)。

在紧要关头，你可以做一个真实的现场演示，因为你的观众（视频演示是否等同于视频演示？）是程序员，并且会理解你遇到的任何问题。

于 2009-01-17T23:59:04.637 回答
0

我对我做了这件事，并认为这是最好的解决方案：

找另一个人来帮助你。在谈论代码时，让助手键入代码。这样，房间里的每个人都会一边看代码，一边听你解释。

这当然涉及找到可以提供帮助并像您一样理解代码的人。但结果可能很棒。

于 2009-01-18T00:00:56.207 回答
0

如果您可以在截屏视频中完成所有操作并且您不必在场，那么请进行截屏视频并且不要在场。当会议被取消时，没有人会抱怨。只需分发视频，可能还附上带有注释或链接的报告，这样人们就可以阅读更多关于您演示的工具的信息。

稍后，当您的同事和经理与其他人交谈时，您会得到更多的赞誉：“嘿，您看到比巴克所做的演示了吗？没有？您应该；午饭后我会把地址发给您。”

如果您在演示文稿中演示代码，那么还可以考虑提供已完成的项目，以便人们可以自己尝试。

于 2009-01-18T00:21:25.637 回答
0

当我进行涉及 Visual Studio 的演示时，我将代码片段放在工具箱的常规选项卡上。在演示过程中，我将这些代码片段拖放到代码文件、标记页等中。

于 2009-12-11T14:58:27.870 回答