在不久的将来,我将有两周的时间来改善我们的工作环境.
我们主要开发一个包含2-10个开发人员的大型PHP/MySQL项目.
目前我们有一个dev服务器,用mod_userdir运行apache,每个dev在他的(samba-accessible)主页中都有一个/ public_html文件夹.对于VCS和Project Management/Issuetracking,我们使用Subversion和Trac.测试/部署需要一些手动步骤,而不是那里的自动化程度.
我对新设置的计划包括对现有设备的以下更改:
您有什么提示/提示可以进一步改进吗？我们应该以不同的方式做什么？
有哪些好的创作工具可以为最终用户创建跨平台的帮助文件？(我们的应用程序使用Qt框架,如果这有任何区别.)
注意:我对内部API文档不感兴趣 - 我们正在使用doxygen.
理想情况下,解决方案是:
我将继续并将其作为维基,并从几个例子开始.如果你有经验,可以投票或者投票,并留下一些评论.还添加其他工具.
我添加了一条\dir注释,为目录提供了附加文档.但我无法使用我所知道的任何doxygen链接技术链接到该目录文档.我的问题是:如何正确链接到目录的文档？
下面是我尝试过的片段.我收到两个警告,没有生成链接.doxygen手册的自动链接部分讨论了与其他成员的链接,但没有提到dirs的链接.是否支持链接到目录文档？如果是这样,我做错了什么或这是一个错误？(我现在正在使用1.8.10.1.8.9.1表现相同.)
这是我尝试过的.我已经记录了使用目录
/// \dir cpp/vtutil
///
/// \brief Brief description of the dir cpp/vtutil goes here
///
/// \details A more detailed description goes here.
///
我使用引用目录
/// \file
/// \brief Implements the vt application class.
///
/// This file is in the \ref cpp/vtutil directory.
/// What about #cpp/vtutil
以下是警告:
warning : unable to resolve reference to `cpp/vtutil' for \ref command
warning : explicit link request to 'cpp' could not be resolved
该文档用于目录,但似乎没有办法引用它.我真诚地感谢任何帮助.
我正在使用 PySpark 并加载csv文件。我有一列带有欧洲格式的数字，这意味着逗号替换了点，反之亦然。
例如：我有2.416,67而不是2,416.67.
My data in .csv file looks like this -
ID; Revenue
21; 2.645,45
23; 31.147,05
.
.
55; 1.009,11
在 Pandas 中，通过在内部指定decimal=','和thousands='.'选项pd.read_csv()来读取欧洲格式，可以轻松读取这样的文件。
熊猫代码：
import pandas as pd
df=pd.read_csv("filepath/revenues.csv",sep=';',decimal=',',thousands='.')
我不知道如何在 PySpark 中做到这一点。
PySpark 代码：
from pyspark.sql.types import StructType, StructField, FloatType, StringType
schema = StructType([
StructField("ID", StringType(), True),
StructField("Revenue", FloatType(), True)
])
df=spark.read.csv("filepath/revenues.csv",sep=';',encoding='UTF-8', schema=schema, header=True)
谁能建议我们如何使用上述.csv()函数在 PySpark 中加载这样的文件？
有没有工具可以帮助绘制大型C库的图表？我正在开发一个项目,将现有的C库移植到C++.C库很大程度上没有文档,没有图表.我想使用CASE工具来帮助我理解各种文件的交互方式.大多数文件中都有外部变量.
如果可能的话,我更愿意使用可视化图来更好地理解代码的流程.我不熟悉程序语言的图表工具(或者如果它存在的话).我记得在大学里我们使用层次结构和数据流程图来处理程序语言.
我知道有许多用于绘制OO语言的工具,但我想要一个C语言.任何帮助都将受到赞赏.
意见建议:
它可以通过三种方式帮助您:
它可以从一组记录的源文件生成在线文档浏览器(以HTML格式)和/或离线参考手册(in).还支持在RTF(MS-Word),PostScript,超链接PDF,压缩HTML和Unix手册页中生成输出.文档直接从源代码中提取,这使得文档更容易与源代码保持一致.您可以配置doxygen以从未记录的源文件中提取代码结构.这对于在大型源代码分发中快速找到方法非常有用.您还可以通过包含依赖图,继承图和协作图来可视化各种元素之间的关系,这些图都是自动生成的.你甚至可以'滥用'
提高代码库质量.CppDepend是一个简化管理复杂的C\C++(本机,混合和COM)代码库的工具.架构师和开发人员可以通过比较不同版本的代码来分析代码结构,指定设计规则,进行有效的代码审查和掌握演化.这些案例研究表明CppDepend可以深入了解您的架构,设计和实现.重构并改进您的设计和架构.CppDepend提供了有用的图表来分析您的设计和架构.CQL语言使您可以灵活地创建自定义查询并深入了解代码库.这里有一个使用CppDepend来帮助你重构的示例.协助您的迁移.了解现有迁移.
如何记录子类的重写方法或实现的虚方法？我应该使用@copydoc吗？
class A {
/**
* A detailed description........
*/
virtual int foo(int i);
}
class B : public A {
/** {I won't write the same description again.} */
int foo(int i);
}
是否可以在自动创建时动态地(例如在Doxyfile中)将doogle 添加到由doxygen生成的HTML文件中？有人可以举例说明如何在GUI或Doxyfile中完成这项工作吗？
我有一个函数的doxygen标题如下:
/** Some description.
@param[in] grid1 First grid
@param[in] grid2 Second grid
@pre grid1 and grid2 must be of the same dimensions
*/
我希望grid1并grid2在生成的文档的前置条件部分中特别突出显示,因为它们是参数.在我看来,我应该能够做类似的事情
@pre #grid1 and #grid2 must be the same size
但这不起作用.
有关如何实现这一点的任何想法？
我想在我的doxygen输出中插入一个编号(或其他,我不挑剔)的脚注.该特殊命令的列表不包括任何东西,我可以认同为启用此.我希望有类似的东西:
This is my text.\footnote{This is my footnote}
这将产生
这是我的文字.1
然后
1:这是我的脚注
在页面的底部.有没有办法实现这个或功能相同的东西？