我应该把关于Kotlin源文件的评论放在哪里？
类和其他对象具有KDoc：
/**
* Summary
*
* Rest of documentation goes here.
*/
class A {
...
}
但我该把这样的东西放哪儿呢？
// This file contains constants shared between frontend and backend.
// Make sure not to use any JVM- or JS-specific import.
// ...
在package声明之前？在那之后？我应该使用KDoc注释/块注释/行注释
浏览 1提问于2018-10-07得票数 7
回答已采纳
ext-all-调试器is和ext-all dev.js之间的主要区别是什么？
“ext-all-调试器”主要用于开发和调试。
使用"ext-all-dev.js“会有什么好处吗？
请澄清。
浏览 7提问于2014-03-04得票数 5
回答已采纳
有人设置过yuidoc来使用coffeescript吗？这是我的yuidoc.json文件：
{
"name": "App",
"description": "App",
"version": "1",
"url": "http://example.com",
"options": {
"paths": [
"./"
],
"exclude&
浏览 1提问于2013-03-08得票数 0
回答已采纳
我有函数s1.js、函数s2.js和函数s3.js。每个函数都有一个函数，分别是funcA、funcB和funcC。我创建了一个名为"functions.intellisense.js“的文件，并将其添加到_reference.js中。然后，我在我的_reference.js文件中添加了对test.js的引用。
为什么intellisense不能工作？
functions.intellisense.js
intellisense.annotate(funcA, function () {
/// <signature>
/// <summary>
浏览 2提问于2013-04-19得票数 0
回答已采纳
如何从main.js轻松地访问变量"test“？
\my-addon-project
\data
\file.js (var test = "123")
\lib:
\main.js
主要问题是，如何将file.js包含在main.js中。以及如何获得变量"test“的值。
有要求吗？找了几个小时这个简单的问题。
请帮帮我。谢谢。
浏览 5提问于2014-02-19得票数 1
回答已采纳
1回答
问题陈述：
提取文件名，如果文件名上有jQuery，则读取文件名，将其放在一边。
第二步是再检查一个，看看是否有任何jQuery文件在文件名中有ui。
输入：
script_ref1 = """<script type="text/javascript" src="js/jquery-1.9.1.min.js"/>
<script type="text/javascript" src="js/jquery-migrate-1.2.1.min.js"/>
<scr
浏览 0提问于2015-06-10得票数 0
回答已采纳
我以前见过它，但我记不清他们使用了哪个项目或哪个文档(如果有的话)。我很确定这是一个JS项目，可能是一个Node.JS模块。
无论如何，文档是按文件列出的，每个页面显示为2列，一列包含内联文档，另一列包含代码。
有谁知道哪些工具可以做到这一点吗？
浏览 0提问于2012-06-29得票数 0
回答已采纳
2回答
我注意到每个方法在源代码中都有如下注释：
/**
* @private
* @method _onDropOver
* @param Event e The Event Object
* @description Handles the DropOver event to append a drop node to an empty target
*/
我很好奇--这看起来像是有什么东西在读取它，并将其转换为文档。？
..。另外，我看过一些.js文件，它们实际上写着：{'version'：'@version'}..
浏览 1提问于2011-04-26得票数 2
回答已采纳
1回答
如何在Pug的评论中添加脚本？我有两个脚本要包含在我的网页上：
<!--[if lt IE 9]>
<script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
<script src="https://oss.maxcdn.com/libs/respond.js/1.3.0/respond.min.js"></script>
<![endif]-->
浏览 1提问于2017-02-22得票数 0
我正在查看JS的角度文档。我无法理解我在下面的代码中提到的一行。有人能解释吗？
script.js：
angular.module('scopeExample', [])
.controller('MyController', ['$scope', function($scope) { // This line
$scope.username = 'World';
$scope.sayHello = function() {
$scope.greeting = 'Hello ' + $scope.
浏览 6提问于2017-08-05得票数 1
回答已采纳
Javascript中代码注释的正确方式是什么-语法与Java中的语法相同吗？哪些工具实际上会利用这些注释：
/*
* Add an element to the group
* @param {Object} overlayElement
* @param {Object} [element2] optional element
*/
我发现新的ReSharper6(我在VisualStudio 2010中编写JS )提供了与C#中相同的注释，但仅在函数体中，类似于/// <param name="overlayElement"></
浏览 1提问于2011-07-25得票数 12
回答已采纳
我有一个集成了Swagger的RESTful API，所以现在可以使用浏览器指向该服务器，并查看用于该API的Swagger文档。我想使用swagger-js项目从服务器上的Swagger数据中生成Javascript中的客户端SDK。
它似乎可以生成这个客户端SDK，我可以在工具中按对象和函数探索SDK对象。但是，我想以某种方式为这个客户端SDK生成文档，这样用户就可以阅读它来查找他们想要的调用，而不必在他们的浏览器开发环境中费力地探索。
例如，如果我的客户端SDK是从Swagger数据生成的，并且具有以下方法：
PetStore.addPet(petData)
PetStore.updat
浏览 0提问于2015-09-21得票数 1
回答已采纳
我在使用angular.js制作的现有站点上工作，它消耗了一些REST。
是否有一种方法从客户端的角度从现有站点开始生成swagger文档，至少是一些框架？
我想避免写文件乞讨。最好在现有代码的基础上生成一些起点文档，然后对其进行细化。
有可能吗？
浏览 5提问于2016-02-04得票数 0
回答已采纳
我有html字符串，正在加载到webview中。记住，html不是一个文件，它只是一个字符串。例如，如果我们的html字符串是，
String html = "<html>
<head>
<title>business card template-2</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body>
<
浏览 2提问于2015-03-17得票数 0
2回答
我有一个像这样的html页面
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script src="JScript2.js" type="text/javascript"></script>
<script src="JScript.js" type="text/javascript"></script>
<title></title>
&
浏览 2提问于2009-12-04得票数 0
回答已采纳
1回答
这是我第一次使用jsdocs3，我无法生成我的文档。我创建了一个文件app.js并插入了以下注释：
/**
* Main file - All modules are loaded.
* @author My Name
*
*/
然后我运行命令./node/jsdoc/jsdoc.js ./app/app.js -r -d docs/，结果如下：
我还使用--debug param尝试了上面的命令，我可以看到jsdocs3能够解析文档并在没有任何错误的情况下完成。
我不知道我做错了什么。有什么可以帮忙的吗？
浏览 2提问于2016-05-14得票数 0
回答已采纳
我想知道如何使用吞咽任务填充index.html。
这是我从index.html那拿的。我想要这个
<!-- build:js js/vendor/libraries.min.js -->
<!-- bower:js -->
<!-- endbower -->
<!-- endbuild -->
在运行一个gulp任务/脚本后看起来像这样。
<!-- build:js js/vendor/libraries.min.js -->
<!-- bower:js -->
<script src="bower_com
浏览 1提问于2015-04-08得票数 0
1回答
我正在创建一个基于的节点应用程序。
server.js有以下内容：
fs.readdirSync(__dirname + "/app/model").forEach(function (file) {
if (~file.indexOf(".js")) {
require (__dirname + "/app/model" + "/" + file);
浏览 2提问于2013-08-06得票数 2
回答已采纳
我正在尝试为工作中的RIA应用程序构建一个JavaScript库。目前，我们有很多包含全局范围内函数的JavaScript文件，我想尝试为我们的函数添加一些合理的命名空间和上下文。可能会将它们转换为对象形式。
我一直在研究其他开源库，以帮助我了解构建库的最佳方法。我在一个特定的开源项目中看到了很多包含以下内容的.js文件。
/**
* @required OpenLayers/Map.js
*/
例如。
除了作为文件中的注释之外，这是否还有其他意义？有没有什么方法可以用这个注释或者像Java语言那样的import语句将其他.js文件导入到你的主构建中呢？
浏览 0提问于2011-02-03得票数 5
2回答
编写如下内容是有效的JavaScript：
function example(x) {
"Here is a short doc what I do.";
// code of the function
}
实际上这条线什么都不做。有什么理由不能用这种方式在JavaScript中评论他/她的功能吗？
在回答这个问题时，我可以想到两点：
必须启动字符串文字，从长远来看，这可能会付出很大的代价。
字符串文字将不被JS微型化器识别为可移动的。
还有其他要点吗？
编辑：为什么提到这个主题:我在上发现了类似的东西，新的ECMA 5标准使用未分配的字符串文字
浏览 1提问于2009-11-09得票数 19
回答已采纳
我们应该使用什么标记来记录带有JSDoc的角JS组件？我在考虑使用@模块，对吗？
例如：
/**
* @module helloWorld
*
* @description AngularJS component to display a message with a name.
*
*/
angular.component('helloWorld', {
bindings: {
name: '@'
},
controller : function helloWorldCtrl () {
this.logName = logName;
浏览 4提问于2017-01-11得票数 2
回答已采纳
我在文件A.js中有一个函数，它接受一个数组，比如在其他文件中定义的Person，entities.js。
A.js
function put(persons) {
}
entities.js
function Person(name) {
this.name = name;
this.age = 10;
}
现在，在A.js中，当我为方法put编写JSdoc时，我应该为人输入什么类型呢？理想情况下，它应该是{Person[]}，但我不知道该如何引用，因为它存在于不同的文件中。有一种方法我可以要求entities.js文件，比如:-
var Person = require(
浏览 6提问于2017-11-06得票数 3
回答已采纳
1回答
目前，我已经掌握了一些DataTables，我尝试了演示代码并对其进行了操作，并且运行良好。现在，我已经有了一个带有动态数据的表，通过一个函数使用php和mysql来拉动表，除了document.ready函数之外，我还向该函数添加了css和js链接，以便在我的表上使用DataTable函数。但是，在添加链接和就绪函数之后，即使在更新id/类名称之后，我的表仍然是旧表。下面是一个代码片段：
include('../session.php');
echo"<script type='text/javascript' src='ht
浏览 7提问于2017-09-11得票数 0
我从Alchemy的情感分析中得到了一个回应，上面说我有一个无效的API密钥。
我使用的是一个基本的HTTP请求和js对象中编码的params，如下所示：
var params = {
apiKey: kAlchemyApiKey,
text: text,
outputMode: 'json'
};
然后提出如下请求：
HTTP.get(kSentimentUrl, params);
API键应该是有效的(但是它是免费的，所以我不知道是否需要设置一些东西才能工作)。
有什么问题吗？我应该使用node.js sdk吗？
================
更
浏览 6提问于2015-07-15得票数 0
我最近开始使用tensorflow.js。我已经到了需要对输出进行一个热编码的地步。对于我的情况，我没有发现搜索tensorflow.js api (tensorflow api正是我作为实用工具搜索的内容，但我使用的是javascript)，我从google中找到的唯一帮助是pythonkerasto_categorical()。
我想确切地从以前在tensorflow.js中经历过这种情况的人那里知道，因为我即将基于python/keras to_categorical()源代码实现自己的函数，那么，是否有类似的util函数可以直接用于to_categorical api中的一个热编码？
浏览 3提问于2020-08-26得票数 1
2回答
我正在使用括号IDE，我尝试了基本的JS。使用对象文档将我发送到一个错误：
“错误：‘文档’没有定义。没有-undef”，
我不知道为什么会发生这个错误，因为它在dreamweaver中很好地工作，有人知道为什么这个错误发生在括号中吗？谢谢。
HTML：
<!DOCTYPE HTML>
<html>
<head>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.2.1/jquery.min.js"></script>
浏览 1提问于2019-01-15得票数 0
回答已采纳
2回答
我正在寻找我们开发的javascript代码的文档，并且正在寻找一些好的javascript文档生成器，有人有什么建议吗？
我们曾经使用ndoc为我们的c#代码创建文档，并且正在寻找类似于文档我们的js代码的东西-理想的是可以从命令行运行的东西。
提前感谢！
浏览 2提问于2012-02-13得票数 13
回答已采纳
在Node.js中，有一个package.json文件，其中包含一个模块上的多个元数据，例如它的名称、版本、作者、…。
你是怎么在围棋里做到的？
例如，我想将Go模块的作者存储在代码的某个地方。如何做到这一点有共同的方法吗？
浏览 3提问于2015-11-08得票数 5
回答已采纳
2回答
我最近仔细研究了JS代码，发现了以下注释：
/**
* Explicitly set the return type here to prevent the primitive being lost when using new
* @return {boolean}
*/
function giveMeABoolean(please) {
...
}
怎么回事？JS中的返回类型？我一直在网上闲逛，什么都找不到。经过一些测试之后，在使用新时，原语确实丢失了，而没有注释。有人能解释一下这个注释是如何工作的吗？
浏览 3提问于2016-11-11得票数 12
回答已采纳
我有一些使用angular 2的经验，但我对框架还是比较新的。当我环顾四周时，我发现了一种叫做ngdocs的东西。它非常好用，因为它基于代码中的注释为您创建了一种文档/ wiki区域。(类似于js文档)。然而，它似乎是专门为angular 1.XX编写的。
我已经做了一些搜索，但似乎找不到任何可以为angular 2提供类似功能的东西。有人知道angular 2是否有类似于ng-docs的功能吗？
浏览 2提问于2016-05-09得票数 9
我有一个在生产文件中缓存的小问题Mb有人知道我如何在dist中指定js和css文件的自定义名称，如chunk-24545415.js?v=232315或b有人知道这方面的一些指南
浏览 9提问于2020-04-20得票数 2
我们有一个非常古老的应用程序，可以追溯到ASP时代，我们正在逐步重构到ASP.NET + VB.NET代码库。
它包含大量如下类型的文件：
aspx、asmx、ascx、vb、js (JavaScript)、html、vbs (VBScript)。
后端数据库是具有大量存储过程的SQL Server 2005。
我们想创建一个从代码文件中的注释自动生成的代码文档。我非常喜欢Doxygen，但它似乎不支持上述技术。您能否推荐一些文档生成器工具，最好是单个工具或一组工具？
非常感谢。
阿吉特。
浏览 0提问于2009-07-21得票数 1
1回答
我有下面的猫鼬模型和路由文件。
user.js
var mongoose = require('mongoose'),
Schema = mongoose.Schema,
ObjectId = Schema.ObjectId,
var userSchema = new Schema({
nick_name: {
type: String,
unique: true
},
email: {
type: String,
浏览 1提问于2016-05-06得票数 3
我试图访问AngularJS的文档页：
但是我注意到脚本链接被破坏了，页面也因此被打破了。是否有供交互文档使用的替代资源？
备注
似乎除了使用1.2.0__的主页之外：
Request URL:http://ajax.googleapis.com/ajax/libs/angularjs/1.2.0/angular.js
Request Method:GET
Status Code:304 Not Modified
这些链接在官方网站的大部分页面上都被打破了。
Request URL:http://ajax.googleapis.com/ajax/libs/angularjs
浏览 2提问于2013-11-15得票数 3
回答已采纳
我有一个这样的类：
class StaticStorage(ManifestFilesMixin, S3BotoStorage):
def __init__(self, *args, **kwargs):
kwargs['custom_domain'] = settings.CUSTOM_STATIC_URL
kwargs['location'] = 'static'
super().__init__(*args, **kwargs)
我使用它作为我的静态资产的存储：
STATICFILES
浏览 1提问于2015-03-30得票数 0
1回答
当回复已经发布的评论时，注释-respony.js(或'min‘版本)被用来将评论表单移动到被回复的评论下面。
它还将重点放在实际的“注释”文本区域。如果有人评论是登录，这是有意义的，因为它是唯一需要和显示的输入。如果注释没有登录，但之前已经发表过评论，则显示“作者”、“电子邮件”和“url”输入，但已经填写完毕，因此再次关注注释文本区域是有意义的。
然而，在许多网站上，评论一般都来自没有登录的普通访问者，他们之前没有发表评论，因此至少需要完成姓名输入，但重点仍然直接放在评论文本区域，这似乎是奇怪的、违反直觉的行为。
第一个问题:有什么很好的理由可以解释为什么这是我看不到的最好的行为吗
浏览 0提问于2014-07-22得票数 0
回答已采纳
我有一个简单的Go HTML模板，它包含HTML条件注释：
package main
import (
"html/template"
"os"
)
var body = `<!doctype html>
<html>
<head>
<!--[if !IE]><!--><script src="http://code.jquery.com/jquery-2.0.3.min.js"></script><!--<![endi
浏览 7提问于2013-12-16得票数 6
回答已采纳
我试图使用库来打包和缩小所有的JavaScripts和CSS，最低限度的代码：
js := bytes.Buffer{}
dat, err := ioutil.ReadFile(fname)
if L.Check(err, `File doesn't exists: `+fname) == nil {
dat, err = min.MinifyBytes(`text/js`, dat)
js.Write(dat)
js.WriteRune(';')
}
但是当err="max buffer exceeded"缩小和 (>400 KB)
浏览 2提问于2015-03-09得票数 0
回答已采纳
2回答
Emacs中函数的注释
、、、、
我正在寻找一种方法来在Emacs中(在任何模式下)在我的函数之上生成和插入标题注释块，并根据该函数的签名(即@param place-holders的正确数量)自动生成注释的默认内容。
是个不错的候选人。但是我更喜欢另一种没有必要的语言的工作方式。有人能推荐一些在Emacs中为函数添加智能注释的其他方法吗？谢谢。
编辑：，现在我发现了这个：，但是在我需要它到.emacs中并为js模式添加钩子之后，它似乎不能很好地工作。它不支持js函数吗？
浏览 1提问于2012-03-26得票数 2
回答已采纳
2回答
通过ajax刷新页面
、、、
例如，我在html文件中有一个元素
<div id="dateRange">1d</div>
它由javascript函数控制
$("#30Days").click(function(){
$(".dateRange").html("30d");
});
$("#12Weeks").click(function(){
$(".dateRange").html("12w");
});
$(
浏览 0提问于2016-04-14得票数 0
我使用的是js的Rails3资产管道。我想将一些第三方库包装在一个命名空间中，但是我无法让它工作。例如，如下所示
var myns= function() {
//= require swfobject
};
按字面意思产生：
var myns= function() {
//= require swfobject
};
也就是说，require没有被调用。资产管道语法如此脆弱吗？在哪里记录了这个限制？有没有变通或者更好的方法？
浏览 0提问于2012-04-24得票数 0
回答已采纳
1回答
当为scanStatus == 'limit'时，centerPopup()和loadPopup()函数不会触发。
这些函数是从名为js/count.js的文件中调用的。该文件可在上找到。
这些是我的函数，存储在js/popup.js中
// Loading popup with jQuery magic!
function loadPopup() {
// Loads popup only if it is disabled
if (popupStatus == 0) {
$("#backgroundPopup").css({
浏览 0提问于2011-12-23得票数 0
回答已采纳
我一直在读罗伯特·马丁的“清洁密码”一书。他的核心租户之一是删除不必要的注释，并努力创建有意义的变量/方法名称，这些名称都是自我记录的。
我的一些同事不同意这种方法，认为这对大型软件项目是不切实际的。他们引用了jQuery的代码库的例子，其中散落着注释，不清楚的变量名称，比如fn，有时甚至注释掉代码，例如jquery/delayred.js。
他们的结论是，开放源代码并不能真正遵循清晰的编码原则，因为人们希望逐行解释为什么会使用特定的方法，因此，自由的注释是必要的。他们还认为，Bob叔叔提倡的长描述性方法名称比带有描述性函数注释的短名称更难阅读。
你认为这个结论是真的吗？如果没有，您有忠实遵循
浏览 0提问于2015-09-16得票数 3
可以在新的app/assets/application.js文件中注释掉这一行吗？如果是这样的话，是怎么做的？
//=require jquery_ujs
我的意思是，它已经被注释掉了，以避免被误解为CoffeeScript或JavaScript，但它显然仍在发挥作用。
浏览 5提问于2011-05-21得票数 18
回答已采纳
1回答
我正在使用mongodb和nodejs。我刚开始使用mongodb。我有一个query.Here是我的mongdb文档：
{
"_id": ObjectId("564dacf84d52785c1d8b4567"),
"content": "This blog created by karanSofat",
"html": "<p>This blog created by karanSofat</p>\n",
"saved_at": I
浏览 0提问于2015-11-19得票数 2
2回答
我无法理解IE中的条件注释在HTML5 5-样板中的一个位置。是关于这部分的
<!--[if gt IE 8]><!--> <html class="no-js"> <!--<![endif]-->
以下两种情况很简单，
在IE6/7的情况下，“如果GT-IE8”条件是假的，因此它输出<!-- -->；
在非IE的情况下，"if gt IE8“和"endif”不被识别，因此"<!--[if gt IE 8]><!-->“和"<!--<![
浏览 2提问于2013-08-29得票数 3
这两者有什么区别？
/**
* comment goes here (notice the extra '*' in previous line)
*/
这个呢？
/*
* comment goes here (notice the extra '*' is not present in previous line)
*/
因为我注意到在eclipse中，这两种评论风格都有不同的颜色，。第一名获得蓝色，第二名获得绿色。
这两种评论风格有什么区别吗？
浏览 17提问于2011-03-30得票数 4
回答已采纳
3回答
如果在我的软件中间，我有一个变量，我需要解释它是什么，它是用来做什么的，我需要记录这个变量。
我有JS的背景，所以我就是这么做的：
/**
* Explain what the variable is, and what is for.
* @variable {Object} nameOfVariable
*/
var nameOfVariable = []
在python的情况下：
# ??
name_of_variable = []
对于这种类型的事情有约定吗？
非常感谢。
浏览 1提问于2016-12-15得票数 0
1回答
Uglifyjs改变角脚本
、、、、
为了通过 gulp 压缩js文件，我尝试使用了两个gulp模块
但它改变了我定义的变量。
例如：
var app = angular.module('myApp', [])
.config(function($interpolateProvider){
$interpolateProvider.startSymbol('{[').endSymbol(']}');
});
压缩为：
var app = angular.module("myApp",[])
.config(f
浏览 2提问于2014-05-13得票数 1
回答已采纳
1回答
"~/Scripts/jquery-ui-{version}.js",
"~/Scripts/jquery-ui.unobtrusive-{version}.js",
"~/Scripts/jquery.validate-vsdoc.js",
"~/Scripts/jquery.validate.js",
"~/Scripts/jquery.validate.unobtrusive.js"
浏览 2提问于2013-06-18得票数 0
回答已采纳
扫码
添加站长 进交流群
领取专属 10元无门槛券
手把手带您无忧上云
相关资讯
热门标签
云服务器
ICP备案
对象存储
即时通信 IM
实时音视频活动推荐
腾讯云开发者
