牵着老婆满街逛
牵着老婆满街逛

使用doxygen

使用doxygen

  撰文 / K.Young          翻译 / 马维达

（ 已发表在《程序员》2002年第3期上）

一、介绍

GLAST 软件已采用 doxygen （ GNUGPL 软件）来作为文档工具，本文将对其进行简单的介绍。要了解更详细的信息及下载 doxygen 程序，请访问网站 什么是 doxygen 呢？下面的介绍录自 doxygen 的网页：

“ doxygen 是一种用于 C++ 、 IDL （ Corba 、 Microsoft 和 KDE-2DCOP 风格）和 C 的文档系统。它可以通过三种方式来帮助你：

1.         它可以从一组标有文档的源文件中生成在线文档浏览器（ HTML 格式），以及 / 或者离线参考手册（ LATEX 格式）。同时还支持生成 RTF （ MS-Word ）、 Postscript 、超链接 PDF 、压缩 HTML 和 UNIXman 页面格式的输出。文档是从源文件中直接提取的，从而十分容易保持文档和源码的一致。

2.       可配置 doxygen ，用以从没有标注文档的源文件中提取代码结构。这对于要在大量源文件中快速地找到所需的东西来说是非常有用的。通过 include 依赖图、继承图和协作图等手段（它们都是自动生成的），可以使不同成分之间的关系可视化。

3.       你甚至还可以“滥用” doxygen ，创建普通文档。”

二、 doxygen 注释风格

使用 doxygen 的第一步是在你的代码中插入 doxygen 风格的注释。你可以使用两种不同风格的 doxygen 注释：

Qt 风格，专用文档块看起来是这样的：
/*!
...text...
*/

还有单行版本：
file://!...onelineoftext... JavaDoc 风格，专用文档块看起来是这样的：
/**
 *...text...
 */

还有单行版本：
///...onelineoftext...
    从现在起我将在例子中使用 Qt 风格，但是你可以在你的代码中使用任何一种。

    你可以通过许多方式使用 doxygen 注释，以为你的代码编写文档。但下面的一种，我们感觉能够令人满意地工作。注意下面的注解仅仅说明应该如何使用 doxygen 注释；你所应该包含在注释里的信息是另外一回事，并不在这里进行讨论。

    我们的基本想法是你想要为每个类、以及该类的重要成员函数增加短注释和长注释。短注释应给出类或函数的基本信息的简要描述。而较长的注释，不奇怪，应该给出更长和更完整的描述。类的短注释和长注释，以及成员函数的简短描述，将放在头文件中。成员函数的长注释将出现在成员函数的实现出现的地方。

    下面的例子演示这一注释系统（向 Alexandre 、 Regis 和 Jose 道歉，我在此过程中“黑”了他们的代码）。假定我们正在为一种叫作 CalPack 的 CMT 包工作，它有一个单独的类 CsICluster ，头文件叫作 CsICluster.h ，在 CalPack/ 目录中；而实现文件叫作 CsICluster.cpp ，在 src/ 目录中。文件 CalPack/CsICluster.h 是这样的：

    而文件 src/CsICluster.cpp 是这样的：

    注意，你可能会选择省略那些含义清楚的成员函数的较长注释，这并不会导致任何问题。访问 文档。

    三、使用 mainpage.h 文件

    浏览上面的链接中的文档，你可能会注意到名为“ MainPage ”的链接（它指向 index.html ）并不是十分有趣。这是一个特殊的页面，在这里你可以添加与你的 doxygen 页面描述的所有类有关的文档。在我们的例子中只有一个单独的类，但是你可以使用 doxygen 来处理如你所选择的那么多的类。一种自然的划分是为每一个 GLASTCMT 包都创建 doxygen 页面。于是合乎想像地，我们想要这个主页面成为对正在被讨论的包的描述；在我们的个案中就是 CalPack 包。

    那么我们怎么为此主页面增添内容呢？你需要使用 doxygen 的特殊命令 \mainpage 。在 doxygen 中有一些特殊命令，它们放在 doxygen 注释中以增强你所生成的文档。例如在类描述中，我们已经使用了 doxygen 特殊命令 \author 。

    命令 \mainpage 指定用以填充主页面的注释的内容。 doxygen 允许你将此命令放在任何注释中。 但是， GLAST 的惯例是将该命令放入文件 mainpage.h 中。这个 mainpage.h 文件应该只包含一条使用 \mainpage 命令的注释。并且这个文件应该放在头文件目录中，也就是，与包自己的名字相同的目录。

    于是我们为 CalPack 包创建一个 CalPack/mainpage.h 文件：

    注意在 \mainpage 命令后面的字句是主页面的标题。我们还引入了 \section 命令，其语法你应该可以推论得出。上面的注释所产生的 HTML 输出见 类的文档。

    四、包含图像

    另一个有趣的命令（对此我们希望实施某种标准）是 \image 命令。此命令用于在你的文档中插入图像。 \image 命令可以用在任何注释中。此命令的语法如下所示：

    \imagehtmlmypicture.gif

    尽管我们仅仅显示了 HTML 输出， doxygen 还可以用于创建 latex 、 man 或 rtf 文档。但是，并非所有格式都支持所有的图像类型。因而，有必要指定你所希望在其中包含的图像的输出格式。 doxygen 将在你通过叫作 IMAGE_PATH 的变量所指定的目录中查找图像文件。对此变量的设置以及其他的 doxygen 缺省值将在下面的“运行 doxygen ”中解释。 目前，只需注意 GLAST 的惯例是在你的文档中为给定的包所使用的全部图像文件都将放在叫作 doc/images/ 的目录中。

    于是假设有一个叫作 figuresim2.gif 的图像文件在目录 doc/images/ 中，我们想要将其插入我们的主页面，我们可以通过简单的改动来完成：

    所产生的 HTML 输出见 五、运行 doxygen

    你可以通过两种方式来运行 doxygen 。注意两种方法都需要你将 doxygen 安装在你的访问路径上。请访问 doxygen 的主页以获得下载和设置可执行程序的相关信息。

    1)        对于 vcmt 用户，你可以简单地点击 doxygen 区域中的“ create ”按钮，从而为你选择的所有包创建 HTML 文档。然后点击“ examine ”来查看页面。

    2)      对于非 vcmt 用户，你首先需要创建一个 Doxyfile 。 Doxyfile 允许你设置运行 doxygen 所需的所有设置和路径。要创建 Doxyfile ，执行

    doxygen–g<filename>

    “ filename ”指定含有 doxygen 设置的文件的名字；如果不指定名字，该文件就叫作“ Doxyfile ”。使用 Doxyfile 时你可能想要设置一些参数。我将提及三个有趣的参数，其他的请参考 doxygen 主页。

    ● INPUT ：此参数指定 doxygen 在其中搜索源码的目录。对于上面的例子，需要设置

      INPUT=srcCalPack

    ● FILE_PATTERNS ：此参数指定 doxygen 所要解析的文件的类型。对于上面的例子，
       需要设置

      FILE_PATTERNS=*.cpp*.h

    ● IMAGE_PATH ：此参数指定 doxygen 在哪里查找使用 \image 命令包含的图像。对
       于上面的例子（并且作为 GLAST 的惯例），需要设置

      INCLUDE_PATH=doc/images

    一旦你设置了这些参数以及其他任何你想要改变的参数，你就可以运行 doxygen 了。假定你的 Doxyfile 就叫作“ Doxyfile ”，执行

    doxygenDoxyfile

    它将解析你指定的所有文件。缺省地， HTML 输出将被放在叫作 html/ 的目录中（这也可以在 Doxyfile 中改变）。

    译者注：

    1.        doxygen 有内建的多语言支持，目前支持 24 种语言，其中包括中文。具体用法请参考 doxygen 的参考手册。

    2.      GLAST 是 TheGammaRayLargeAreaSpaceTelescope （伽玛射线大区域空间望远镜）的缩写。主页在 访问其源码。 /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT:7PT'TIMESNEWROMAN'"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="MARGIN-LEFT:18PT;TEXT-INDENT:-18PT;WORD-BREAK:BREAK-ALL"> /PCLASS=MSONORMALSTYLE="WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="MARGIN-LEFT:18PT;TEXT-INDENT:-18PT;WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="MARGIN-LEFT:18PT;TEXT-INDENT:-18PT;WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="TEXT-INDENT:21PT;WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="TEXT-INDENT:21PT;WORD-BREAK:BREAK-ALL"> /PCLASS=MSONORMALSTYLE="WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="TEXT-INDENT:21PT;WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="TEXT-INDENT:21PT;WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="TEXT-INDENT:21PT;WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="TEXT-INDENT:21PT;WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /LICLASS=MSONORMALSTYLE="MARGIN-BOTTOM:12PT;TEXT-ALIGN:LEFT;WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="MARGIN-LEFT:18PT;TEXT-INDENT:-18PT;WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT:7PT'TIMESNEWROMAN'"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT:7PT'TIMESNEWROMAN'"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PCLASS=MSONORMALSTYLE="TEXT-INDENT:21PT;WORD-BREAK:BREAK-ALL"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /PALIGN=CENTERCLASS=MSONORMALSTYLE="TEXT-ALIGN:CENTER;TEXT-INDENT:42PT"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312"> /SPANSTYLE="FONT-FAMILY:楷体_GB2312">

    你可能感兴趣的:(使用doxygen)

    • element实现动态路由+面包屑 软件技术NINI vue案例vue.js前端
      el-breadcrumb是ElementUI组件库中的一个面包屑导航组件，它用于显示当前页面的路径，帮助用户快速理解和导航到应用的各个部分。在Vue.js项目中，如果你已经安装了ElementUI，就可以很方便地使用el-breadcrumb组件。以下是一个基本的使用示例：安装ElementUI（如果你还没有安装的话）:你可以通过npm或yarn来安装ElementUI。bash复制代码npmi
    • C语言宏函数 南林yan C语言c语言
      一、什么是宏函数？通过宏定义的函数是宏函数。如下，编译器在预处理阶段会将Add(x,y)替换为((x)*(y))#defineAdd(x,y)((x)*(y))#defineAdd(x,y)((x)*(y))intmain(){inta=10;intb=20;intd=10;intc=Add(a+d,b)*2;cout<
    • C语言如何定义宏函数？ 小九格物 c语言
      在C语言中，宏函数是通过预处理器定义的，它在编译之前替换代码中的宏调用。宏函数可以模拟函数的行为，但它们不是真正的函数，因为它们在编译时不会进行类型检查，也不会分配存储空间。宏函数的定义通常使用#define指令，后面跟着宏的名称和参数列表，以及宏展开后的代码。宏函数的定义方式：1.基本宏函数：这是最简单的宏函数形式，它直接定义一个表达式。#defineSQUARE(x)((x)*(x))2.带参
    • c++ 的iostream 和 c++的stdio的区别和联系 黄卷青灯77 c++算法开发语言iostreamstdio
      在C++中，iostream和C语言的stdio.h都是用于处理输入输出的库，但它们在设计、用法和功能上有许多不同。以下是两者的区别和联系：区别1.编程风格iostream（C++风格）：C++标准库中的输入输出流类库，支持面向对象的输入输出操作。典型用法是cin（输入）和cout（输出），使用>操作符来处理数据。更加类型安全，支持用户自定义类型的输入输出。#includeintmain(){in
    • Long类型前后端数据不一致 igotyback 前端
      响应给前端的数据浏览器控制台中response中看到的Long类型的数据是正常的到前端数据不一致前后端数据类型不匹配是一个常见问题，尤其是当后端使用Java的Long类型（64位）与前端JavaScript的Number类型（最大安全整数为2^53-1，即16位）进行数据交互时，很容易出现精度丢失的问题。这是因为JavaScript中的Number类型无法安全地表示超过16位的整数。为了解决这个问
    • 消息中间件有哪些常见类型 xmh-sxh-1314 java
      消息中间件根据其设计理念和用途，可以大致分为以下几种常见类型：点对点消息队列（Point-to-PointMessagingQueues）：在这种模型中，消息被发送到特定的队列中，消费者从队列中取出并处理消息。队列中的消息只能被一个消费者消费，消费后即被删除。常见的实现包括IBM的MQSeries、RabbitMQ的部分使用场景等。适用于任务分发、负载均衡等场景。发布/订阅消息模型（Pub/Sub
    • html 中如何使用 uniapp 的部分方法 某公司摸鱼前端 htmluni-app前端
      示例代码：Documentconsole.log(window);效果展示：好了，现在就可以uni.使用相关的方法了
    • ArcGIS栅格计算器常见公式（赋值、0和空值的转换、补充栅格空值） 研学随笔 arcgis经验分享
      我们在使用ArcGIS时通常经常用到栅格计算器，今天主要给大家介绍我日常中经常用到的几个公式，供大家参考学习。将特定值（-9999）赋值为0，例如-9999.Con("raster"==-9999,0,"raster")2.给空值赋予特定的值（如0）Con(IsNull("raster"),0,"raster")3.将特定的栅格值(如1)赋值为空值，其他保留原值SetNull("raster"==
    • 高级编程--XML+socket练习题 masa010 java开发语言
      1.北京华北2114.8万人上海华东2,500万人广州华南1292.68万人成都华西1417万人（1）使用dom4j将信息存入xml中（2）读取信息，并打印控制台（3）添加一个city节点与子节点（4）使用socketTCP协议编写服务端与客户端，客户端输入城市ID，服务器响应相应城市信息（5）使用socketTCP协议编写服务端与客户端，客户端要求用户输入city对象，服务端接收并使用dom4j
    • 水平垂直居中的几种方法（总结） LJ小番茄 CSS_玄学语言htmljavascript前端csscss3
      1.使用flexbox的justify-content和align-items.parent{display:flex;justify-content:center;/*水平居中*/align-items:center;/*垂直居中*/height:100vh;/*需要指定高度*/}2.使用grid的place-items:center.parent{display:grid;place-item
    • 【一起学Rust | 设计模式】习惯语法——使用借用类型作为参数、格式化拼接字符串、构造函数 广龙宇 一起学Rust#Rust设计模式rust设计模式开发语言
      提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档文章目录前言一、使用借用类型作为参数二、格式化拼接字符串三、使用构造函数总结前言Rust不是传统的面向对象编程语言，它的所有特性，使其独一无二。因此，学习特定于Rust的设计模式是必要的。本系列文章为作者学习《Rust设计模式》的学习笔记以及自己的见解。因此，本系列文章的结构也与此书的结构相同（后续可能会调成结构），基本上分为三个部分
    • Python数据分析与可视化实战指南 William数据分析 pythonpython数据
      在数据驱动的时代，Python因其简洁的语法、强大的库生态系统以及活跃的社区，成为了数据分析与可视化的首选语言。本文将通过一个详细的案例，带领大家学习如何使用Python进行数据分析，并通过可视化来直观呈现分析结果。一、环境准备1.1安装必要库在开始数据分析和可视化之前，我们需要安装一些常用的库。主要包括pandas、numpy、matplotlib和seaborn等。这些库分别用于数据处理、数学
    • C#中使用split分割字符串 互联网打工人no1 c#
      1、用字符串分隔：usingSystem.Text.RegularExpressions;stringstr="aaajsbbbjsccc";string[]sArray=Regex.Split(str,"js",RegexOptions.IgnoreCase);foreach(stringiinsArray)Response.Write(i.ToString()+"");输出结果：aaabbbc
    • Python中os.environ基本介绍及使用方法 鹤冲天Pro #Pythonpython服务器开发语言
      文章目录python中os.environos.environ简介os.environ进行环境变量的增删改查python中os.environ的使用详解1.简介2.key字段详解2.1常见key字段3.os.environ.get()用法4.环境变量的增删改查和判断是否存在4.1新增环境变量4.2更新环境变量4.3获取环境变量4.4删除环境变量4.5判断环境变量是否存在python中os.envi
    • Python教程：一文了解使用Python处理XPath 旦莫 Python进阶python开发语言
      目录1.环境准备1.1安装lxml1.2验证安装2.XPath基础2.1什么是XPath？2.2XPath语法2.3示例XML文档3.使用lxml解析XML3.1解析XML文档3.2查看解析结果4.XPath查询4.1基本路径查询4.2使用属性查询4.3查询多个节点5.XPath的高级用法5.1使用逻辑运算符5.2使用函数6.实战案例6.1从网页抓取数据6.1.1安装Requests库6.1.2代
    • Google earth studio 简介 陟彼高冈yu 旅游
      GoogleEarthStudio是一个基于Web的动画工具，专为创作使用GoogleEarth数据的动画和视频而设计。它利用了GoogleEarth强大的三维地图和卫星影像数据库，使用户能够轻松地创建逼真的地球动画、航拍视频和动态地图可视化。网址为https://www.google.com/earth/studio/。GoogleEarthStudio是一个基于Web的动画工具，专为创作使用G
    • linux中sdl的使用教程,sdl使用入门 Melissa Corvinus linux中sdl的使用教程
      本文通过一个简单示例讲解SDL的基本使用流程。示例中展示一个窗口，窗口里面有个随机颜色快随机移动。当我们鼠标点击关闭按钮时间窗口关闭。基本步骤如下：1.初始化SDL并创建一个窗口。SDL_Init()初始化SDL_CreateWindow()创建窗口2.纹理渲染存储RGB和存储纹理的区别：比如一个从左到右由红色渐变到蓝色的矩形，用存储RGB的话就需要把矩形中每个点的具体颜色值存储下来；而纹理只是一
    • LLM 词汇表 落难Coder LLMsNLP大语言模型大模型llama人工智能
      Contextwindow“上下文窗口”是指语言模型在生成新文本时能够回溯和参考的文本量。这不同于语言模型训练时所使用的大量数据集，而是代表了模型的“工作记忆”。较大的上下文窗口可以让模型理解和响应更复杂和更长的提示，而较小的上下文窗口可能会限制模型处理较长提示或在长时间对话中保持连贯性的能力。Fine-tuning微调是使用额外的数据进一步训练预训练语言模型的过程。这使得模型开始表示和模仿微调数
    • 下载github patch到本地 小米人er 我的博客gitpatch
      以下是几种从GitHub上下载以.patch结尾的补丁文件的方法：通过浏览器直接下载打开包含该.patch文件的GitHub仓库。在仓库的文件列表中找到对应的.patch文件。点击该文件，浏览器会显示文件的内容，在页面的右上角通常会有一个“Raw”按钮，点击它可以获取原始文件内容。然后在浏览器中使用快捷键（如Ctrl+S或者Command+S）将原始文件保存到本地，选择保存的文件名并确保后缀为.p
    • 使用 FinalShell 进行远程连接（ssh 远程连接 Linux 服务器） 编程经验分享 开发工具服务器sshlinux
      目录前言基本使用教程新建远程连接连接主机自定义命令路由追踪前言后端开发，必然需要和服务器打交道，部署应用，排查问题，查看运行日志等等。一般服务器都是集中部署在机房中，也有一些直接是云服务器，总而言之，程序员不可能直接和服务器直接操作，一般都是通过ssh连接来登录服务器。刚接触远程连接时，使用的是XSHELL来远程连接服务器，连接上就能够操作远程服务器了，但是仅用XSHELL并没有上传下载文件的功能
    • 直返最高等级与直返APP：无需邀请码的返利新体验 古楼
      随着互联网的普及和电商的兴起，直返模式逐渐成为一种流行的商业模式。在这种模式下，消费者通过购买产品或服务，获得一定的返利，并可以分享给更多的人。其中，直返最高等级和直返APP是直返模式中的重要概念和工具。本文将详细介绍直返最高等级的概念、直返APP的使用以及与邀请码的关系。【高省】APP（高佣金领导者）是一个自用省钱佣金高，分享推广赚钱多的平台，百度有几百万篇报道，运行三年，稳定可靠。高省APP，
    • SQL Server_查询某一数据库中的所有表的内容 qq_42772833 SQLServer数据库sqlserver
      1.查看所有表的表名要列出CrabFarmDB数据库中的所有表（名），可以使用以下SQL语句：USECrabFarmDB;--切换到目标数据库GOSELECTTABLE_NAMEFROMINFORMATION_SCHEMA.TABLESWHERETABLE_TYPE='BASETABLE';对这段SQL脚本的解释：SELECTTABLE_NAME：这个语句的作用是从查询结果中选择TABLE_NAM
    • 四章-32-点要素的聚合 彩云飘过
      本文基于腾讯课堂老胡的课《跟我学Openlayers--基础实例详解》做的学习笔记，使用的openlayers5.3.xapi。源码见1032.html，对应的官网示例https://openlayers.org/en/latest/examples/cluster.htmlhttps://openlayers.org/en/latest/examples/earthquake-clusters.
    • 2020-04-12每天三百字之连接与替代 冷眼看潮
      不知道是不是好为人师，有时候还真想和别人分享一下我对某些现象的看法或者解释。人类社会不断发展进步的过程，就是不断连接与替代的过程。人类发现了火并应用火以后，告别了茹毛饮血的野兽般的原始生活（火烧、烹饪替代了生食）人类用石器代替了完全手工，工具的使用使人类进步一大步。类似这样的替代还有很多，随着科技的发展，有更多的原始的事物被替代，代之以更高效、更先进的技术。在近现代，汽车替代了马车，高速公路和铁路
    • 【加密社】Solidity 中的事件机制及其应用 加密社 闲侃区块链智能合约区块链
      加密社引言在Solidity合约开发过程中，事件（Events）是一种非常重要的机制。它们不仅能够让开发者记录智能合约的重要状态变更，还能够让外部系统（如前端应用）监听这些状态的变化。本文将详细介绍Solidity中的事件机制以及如何利用不同的手段来触发、监听和获取这些事件。事件存储的地方当我们在Solidity合约中使用emit关键字触发事件时，该事件会被记录在区块链的交易收据中。具体而言，事件
    • 探索OpenAI和LangChain的适配器集成：轻松切换模型提供商 nseejrukjhad langchaineasyui前端python
      #探索OpenAI和LangChain的适配器集成：轻松切换模型提供商##引言在人工智能和自然语言处理的世界中，OpenAI的模型提供了强大的能力。然而，随着技术的发展，许多人开始探索其他模型以满足特定需求。LangChain作为一个强大的工具，集成了多种模型提供商，通过提供适配器，简化了不同模型之间的转换。本篇文章将介绍如何使用LangChain的适配器与OpenAI集成，以便轻松切换模型提供商
    • 使用Faiss进行高效相似度搜索 llzwxh888 faisspython
      在现代AI应用中，快速和高效的相似度搜索是至关重要的。Faiss（FacebookAISimilaritySearch）是一个专门用于快速相似度搜索和聚类的库，特别适用于高维向量。本文将介绍如何使用Faiss来进行相似度搜索，并结合Python代码演示其基本用法。什么是Faiss？Faiss是一个由FacebookAIResearch团队开发的开源库，主要用于高维向量的相似性搜索和聚类。Faiss
    • 使用LLaVa和Ollama实现多模态RAG示例 llzwxh888 python人工智能开发语言
      本文将详细介绍如何使用LLaVa和Ollama实现多模态RAG（检索增强生成），通过提取图像中的结构化数据、生成图像字幕等功能来展示这一技术的强大之处。安装环境首先，您需要安装以下依赖包：!pipinstallllama-index-multi-modal-llms-ollama!pipinstallllama-index-readers-file!pipinstallunstructured!p
    • python是什么意思中文-在python中%是什么意思 编程大乐趣
      Python中%有两种：1、数值运算：%代表取模，返回除法的余数。如：>>>7%212、%操作符（字符串格式化，stringformatting），说明如下：%[(name)][flags][width].[precision]typecode(name)为命名flags可以有+，-，''或0。+表示右对齐。-表示左对齐。''为一个空格，表示在正数的左侧填充一个空格，从而与负数对齐。0表示使用0填
    • 使用Apify加载Twitter消息以进行微调的完整指南 nseejrukjhad twittereasyui前端python
      #使用Apify加载Twitter消息以进行微调的完整指南##引言在自然语言处理领域，微调模型以适应特定任务是提升模型性能的常见方法。本文将介绍如何使用Apify从Twitter导出聊天信息，以便进一步进行微调。##主要内容###使用Apify导出推文首先，我们需要从Twitter导出推文。Apify可以帮助我们做到这一点。通过Apify的强大功能，我们可以批量抓取和导出数据，适用于各类应用场景。
    • windows下源码安装golang 616050468 golang安装golang环境windows
               系统： 64位win7， 开发环境：sublime text 2，  go版本： 1.4.1    1.  安装前准备(gcc, gdb, git)        golang在64位系
    • redis批量删除带空格的key bylijinnan redis
      redis批量删除的通常做法： redis-cli keys "blacklist*" | xargs redis-cli del 上面的命令在key的前后没有空格时是可以的，但有空格就不行了： $redis-cli keys "blacklist*" 1) "blacklist:12: [email protected]
    • oracle正则表达式的用法 0624chenhong oracle正则表达式
        方括号表达示 方括号表达式 描述 [[:alnum:]] 字母和数字混合的字符 [[:alpha:]] 字母字符 [[:cntrl:]] 控制字符 [[:digit:]] 数字字符 [[:graph:]] 图像字符 [[:lower:]] 小写字母字符 [[:print:]] 打印字符 [[:punct：]] 标点符号字符 [[:space:]]
    • 2048源码(核心算法有，缺少几个anctionbar，以后补上) 不懂事的小屁孩 2048
      2048游戏基本上有四部分组成， 1：主activity，包含游戏块的16个方格，上面统计分数的模块 2：底下的gridview，监听上下左右的滑动，进行事件处理， 3：每一个卡片，里面的内容很简单，只有一个text，记录显示的数字 4：Actionbar，是游戏用重新开始，设置等功能(这个在底下可以下载的代码里面还没有实现) 写代码的流程 1：设计游戏的布局，基本是两块，上面是分
    • jquery内部链式调用机理 换个号韩国红果果 JavaScriptjquery
      只需要在调用该对象合适(比如下列的setStyles)的方法后让该方法返回该对象（通过this  因为一旦一个函数称为一个对象方法的话那么在这个方法内部this（结合下面的setStyles）指向这个对象） function create(type){ var element=document.createElement(type); //this=element;
    • 你订酒店时的每一次点击 背后都是NoSQL和云计算 蓝儿唯美 NoSQL
      全球最大的在线旅游公司Expedia旗下的酒店预订公司，它运营着89个网站，跨越68个国家，三年前开始实验公有云，以求让客户在预订网站上查询假期酒店时得到更快的信息获取体验。 云端本身是用于驱动网站的部分小功能的，如搜索框的自动推荐功能，还能保证处理Hotels.com服务的季节性需求高峰整体储能。 Hotels.com的首席技术官Thierry Bedos上个月在伦敦参加“2015 Clou
    • java笔记1 a-john java
      1，面向对象程序设计（Object-oriented Propramming，OOP）：java就是一种面向对象程序设计。 2，对象：我们将问题空间中的元素及其在解空间中的表示称为“对象”。简单来说，对象是某个类型的实例。比如狗是一个类型，哈士奇可以是狗的一个实例，也就是对象。 3，面向对象程序设计方式的特性：     3.1 万物皆为对象。    
    • C语言 sizeof和strlen之间的那些事 C/C++软件开发求职面试题 必备考点（一） aijuans C/C++求职面试必备考点
              找工作在即，以后决定每天至少写一个知识点，主要是记录，逼迫自己动手、总结加深印象。当然如果能有一言半语让他人收益，后学幸运之至也。如有错误，还希望大家帮忙指出来。感激不尽。        后学保证每个写出来的结果都是自己在电脑上亲自跑过的，咱人笨，以前学的也半吊子。很多时候只能靠运行出来的结果再反过来
    • 程序员写代码时就不要管需求了吗？ asia007 程序员不能一味跟需求走
            编程也有2年了，刚开始不懂的什么都跟需求走，需求是怎样就用代码实现就行，也不管这个需求是否合理，是否为较好的用户体验。当然刚开始编程都会这样，但是如果有了2年以上的工作经验的程序员只知道一味写代码，而不在写的过程中思考一下这个需求是否合理，那么，我想这个程序员就只能一辈写敲敲代码了。       我的技术不是很好，但是就不代
    • Activity的四种启动模式 百合不是茶 android栈模式启动Activity的标准模式启动栈顶模式启动单例模式启动
      android界面的操作就是很多个activity之间的切换,启动模式决定启动的activity的生命周期 ;   启动模式xml中配置     <activity android:name=".MainActivity" android:launchMode="standard&quo
    • Spring中@Autowired标签与@Resource标签的区别 bijian1013 javaspring@Resource@Autowired@Qualifier
      Spring不但支持自己定义的@Autowired注解，还支持由JSR-250规范定义的几个注解，如：@Resource、 @PostConstruct及@PreDestroy。   1. @Autowired    @Autowired是Spring 提供的，需导入    Package:org.springframewo
    • Changes Between SOAP 1.1 and SOAP 1.2 sunjing ChangesEnableSOAP 1.1SOAP 1.2
      JAX-WS SOAP Version 1.2 Part 0: Primer (Second Edition) SOAP Version 1.2 Part 1: Messaging Framework (Second Edition) SOAP Version 1.2 Part 2: Adjuncts (Second Edition)   Which style of WSDL
    • 【Hadoop二】Hadoop常用命令 bit1129 hadoop
      以Hadoop运行Hadoop自带的wordcount为例，   hadoop脚本位于/home/hadoop/hadoop-2.5.2/bin/hadoop，需要说明的是，这些命令的使用必须在Hadoop已经运行的情况下才能执行   Hadoop HDFS相关命令  hadoop fs -ls  列出HDFS文件系统的第一级文件和第一级
    • java异常处理（初级） 白糖_ javaDAOspring虚拟机Ajax
      从学习到现在从事java开发一年多了，个人觉得对java只了解皮毛，很多东西都是用到再去慢慢学习，编程真的是一项艺术，要完成一段好的代码，需要懂得很多。 最近项目经理让我负责一个组件开发，框架都由自己搭建，最让我头疼的是异常处理，我看了一些网上的源码，发现他们对异常的处理不是很重视，研究了很久都没有找到很好的解决方案。后来有幸看到一个200W美元的项目部分源码，通过他们对异常处理的解决方案，我终
    • 记录整理-工作问题 braveCS 工作
      1）那位同学还是CSV文件默认Excel打开看不到全部结果。以为是没写进去。同学甲说文件应该不分大小。后来log一下原来是有写进去。只是Excel有行数限制。那位同学进步好快啊。 2）今天同学说写文件的时候提示jvm的内存溢出。我马上反应说那就改一下jvm的内存大小。同学说改用分批处理了。果然想问题还是有局限性。改jvm内存大小只能暂时地解决问题，以后要是写更大的文件还是得改内存。想问题要长远啊
    • org.apache.tools.zip实现文件的压缩和解压，支持中文 bylijinnan apache
      刚开始用java.util.Zip，发现不支持中文（网上有修改的方法，但比较麻烦） 后改用org.apache.tools.zip org.apache.tools.zip的使用网上有更简单的例子 下面的程序根据实际需求，实现了压缩指定目录下指定文件的方法 import java.io.BufferedReader; import java.io.BufferedWrit
    • 读书笔记-4 chengxuyuancsdn 读书笔记
      1、JSTL 核心标签库标签 2、避免SQL注入 3、字符串逆转方法 4、字符串比较compareTo 5、字符串替换replace 6、分拆字符串 1、JSTL 核心标签库标签共有13个， 学习资料：http://www.cnblogs.com/lihuiyy/archive/2012/02/24/2366806.html 功能上分为4类： (1)表达式控制标签：out
    • [物理与电子]半导体教材的一个小问题 comsci 问题
            各种模拟电子和数字电子教材中都有这个词汇-空穴       书中对这个词汇的解释是; 当电子脱离共价键的束缚成为自由电子之后,共价键中就留下一个空位,这个空位叫做空穴       我现在回过头翻大学时候的教材,觉得这个
    • Flashback Database --闪回数据库 daizj oracle闪回数据库
      Flashback 技术是以Undo segment中的内容为基础的， 因此受限于UNDO_RETENTON参数。要使用flashback 的特性，必须启用自动撤销管理表空间。 在Oracle 10g中， Flash back家族分为以下成员： Flashback Database， Flashback Drop，Flashback Query(分Flashback Query,Flashbac
    • 简单排序:插入排序 dieslrae 插入排序
      public void insertSort(int[] array){ int temp; for(int i=1;i<array.length;i++){ temp = array[i]; for(int k=i-1;k>=0;k--)
    • C语言学习六指针小示例、一维数组名含义，定义一个函数输出数组的内容 dcj3sjt126com c
      # include <stdio.h> int main(void) { int * p; //等价于 int *p 也等价于 int* p; int i = 5; char ch = 'A'; //p = 5; //error //p = &ch; //error //p = ch; //error p = &i; //
    • centos下php redis扩展的安装配置3种方法 dcj3sjt126com redis
      方法一 1.下载php redis扩展包  代码如下 复制代码 #wget http://redis.googlecode.com/files/redis-2.4.4.tar.gz 2 tar -zxvf 解压压缩包，cd /扩展包 （进入扩展包然后 运行phpize 一下是我环境中phpize的目录，/usr/local/php/bin/phpize (一定要
    • 线程池(Executors) shuizhaosi888 线程池
      在java类库中，任务执行的主要抽象不是Thread，而是Executor，将任务的提交过程和执行过程解耦 public interface Executor { void execute(Runnable command); }   public class RunMain implements Executor{ @Override pub
    • openstack 快速安装笔记 haoningabc openstack
      前提是要配置好yum源 版本icehouse，操作系统redhat6.5 最简化安装，不要cinder和swift 三个节点 172 control节点keystone glance horizon 173 compute节点nova 173 network节点neutron control /etc/sysctl.conf net.ipv4.ip_forward =
    • 从c面向对象的实现理解c++的对象（二） jimmee C++面向对象虚函数
      1. 类就可以看作一个struct，类的方法，可以理解为通过函数指针的方式实现的，类对象分配内存时，只分配成员变量的，函数指针并不需要分配额外的内存保存地址。 2. c++中类的构造函数，就是进行内存分配(malloc)，调用构造函数 3. c++中类的析构函数，就时回收内存(free) 4. c++是基于栈和全局数据分配内存的，如果是一个方法内创建的对象，就直接在栈上分配内存了。 专门在
    • 如何让那个一个div可以拖动 lingfeng520240 html
      <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml
    • 第10章 高级事件（中） onestopweb 事件
      index.html <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/
    • 计算两个经纬度之间的距离 roadrunners 计算纬度LBS经度距离
      要解决这个问题的时候，到网上查了很多方案，最后计算出来的都与百度计算出来的有出入。下面这个公式计算出来的距离和百度计算出来的距离是一致的。 /** * * @param longitudeA * 经度A点 * @param latitudeA * 纬度A点 * @param longitudeB *
    • 最具争议的10个Java话题 tomcat_oracle java
      1、Java8已经到来。什么！？ Java8 支持lambda。哇哦，RIP Scala！ 　　随着Java8 的发布，出现很多关于新发布的Java8是否有潜力干掉Scala的争论，最终的结论是远远没有那么简单。Java8可能已经在Scala的lambda的包围中突围，但Java并非是函数式编程王位的真正觊觎者。 　 　2、Java 9 即将到来 　　 Oracle早在8月份就发布
    • zoj 3826 Hierarchical Notation(模拟) 阿尔萨斯 rar
      题目链接：zoj 3826 Hierarchical Notation 题目大意：给定一些结构体，结构体有value值和key值，Q次询问，输出每个key值对应的value值。 解题思路：思路很简单，写个类词法的递归函数，每次将key值映射成一个hash值，用map映射每个key的value起始终止位置，预处理完了查询就很简单了。 这题是最后10分钟出的，因为没有考虑value为{}的情
    按字母分类： ABCDEFGHIJKLMNOPQRSTUVWXYZ其他