译注:StaGen是一个功能极其简单的静态站点生成器,因此它非常容易上手,同时它还是用Java 8写的,有兴趣的话可以看下它的源代码。当然我个人还是比较喜欢
Jekyll。
在没有
StaGen之前,我一直都在用RapidWeaver来管理我的网站
WizTools.org。RapidWeaver生成的文本格式真的让人很抓狂,这个软件浪费了我太多时间。StaGen的诞生解决了这些问题。我连夜完成了第一个版本。第二天就把我的网站WizTools.org给迁移到StatGen上面了。StaGen的设计目标就是希望能让只有少数几个页面的简单站点的开发和管理变得更容易一些。出于这个的考虑,我选择了markdown作为文档格式,StringTemplate作为内容模板,并使用JSON来存储配置信息。
目录结构
StaGen管理的网站项目需要遵循如下的目录结构:
.
`-- content
| |-- index.md
| |-- other.md
`-- config
| |-- other.json
|-- master.json
`-- static
| |-- my.css
`-- template
| |-- index.st
| |-- other.st
各个文件夹的作用如下:
content: 这个文件夹用来存储markdown格式的文档。生成的网站中会为每篇文章都单独生成一个HTML文件。content下面的子目录会被StaGen忽略。
config: 每个页面都可以有一些单独的配置信息。配置信息是用JSON格式来存储的。文件名必须和content中的文件名匹配。
master.json:这是主配置文件。里面存储了网站全局的配置信息。
static: 网站中用到的静态资源文件,比如.js,.css以及图片等。
template: StringTemplate 4模板会放在这个目录下。
StaGen是如何工作的
StaGen引擎处理的顺序是这样的:
1. 加载主配置文件master.json
2. 将静态资源文件拷贝到目标文件夹(网站生成的时候会自动创建一个叫target的文件夹)
3. 对于content目录下的每一个markdown文件:
加载对应的配置信息(下节中会有介绍)
将配置信息应用到对应的模板上,并把结果的HTML文件输出到目标文件夹
加载配置
配置信息是一个JSON类型的map:
{
"title": "My Site Title",
"activities": ["Dance", "Jump", "Shout"]
}
注意,key必须是字符串,值可以是任意类型的。
前面已经提到过,站点的全局配置是master.json。StaGen在一开始的时候便会加载这个配置文件。当处理到每一篇文章时(比如index.md),StaGen会尝试从config/index.json中加载对应的配置信息。它会覆盖掉主配置文件中的配置信息。也就是说,如果你已经在master.json和config/index.json中都定义了标题,当渲染index.md时,使用的是config/index.json里面的配置。如果config/index.json文件不存在,也无所谓——那就用master.json里面的配置好了。
模板渲染
StaGen使用的是StringTemplate作为模板。下面是一个简单的模板,它用到了前面提到的JSON配置信息:
<html>
...
<title>$titleprebuffer_2lt;/title>
...
[list=1]
$activities: {activity|
[*]$activityprebuffer_2lt;/li>
}$
[/list]
...
$_content$
...
</html>
$_content$就是markdown文件渲染出来的HTML。
模板渲染遵循如下的规则:
1. 尝试按文章的名字加载模板,比如content.md,StaGen引擎会加载other.st。
2. 如果没有指定专门的模板,则使用默认的index.st模板。因此你要确保你的项目中确实有一个index.st模板。
模板内嵌套模板
你可以在.st文件里再包含一个别的模板,比如你有一个ga.st(ga->Google Analytics)文件,要引入到主模板文件index.st中。在index.st里面你可以这么写:
$ga()$
index.st里面会包含ga.st渲染后的内容。需要注意的是,index.st中的所有变量对引入的模板都是可见的。
StaGen的使用
StaGen是以一个jar包的形式发布的。想获取这个工具的帮助信息的话:
java -jar ~/stagen-VER-full.jar -h
从项目里生成站点:
java -jar ~/stagen-VER-full.jar gen
上述命令将会在target目录中生成一个静态网站。
想清除target目录的话:
java -jar ~/stagen-VER-full.jar clean
如果你刚开始用StaGen,想创建一个新的项目结构:
java -jar ~/stagen-VER-full.jar init
总结
StaGen故意设计得非常简单。我自己不会用它来管理太复杂的站点。它不像别的静态网站生成器那样能支持博客或者主题。我相信,StaGen不支持这些特性,这也正是它的过人之处。
原创文章转载请注明出处:
http://it.deepinmind.com
英文原文链接
分享到:
相关推荐
exp :RNA-Seq基因表达谱cna :CNV配置文件meth :DNA甲基化谱clinical :临床矩阵(7个变量- time (总生存天数), status (事件状态), age , gender , stageM , stageN , stageT )2.获取多
通常,"stagen"在电子领域可能会与阶段或者步骤有关,但具体含义需要更多上下文来确定。 4. **btg_128128-51驱动**:这里的"51"可能指的是51系列单片机,如常用的8051,这是微控制器的一种,常用于控制LCD显示。...
ASP.NET是一种基于.NET框架的服务器端编程模型,用于构建高性能、易于维护的Web应用程序。在这个中学图书馆系统的案例中,开发者利用ASP.NET的技术栈设计并实现了这样一个功能丰富的平台,旨在为中学生、教师以及图书馆管理员提供方便的信息管理和检索服务。下面我们将深入探讨这个系统的核心知识点。 1. **ASP.NET架构**:ASP.NET提供了多种开发模式,如Web Forms、MVC、Web API和Blazor。本系统可能采用了Web Forms或MVC架构,这两种模式都支持事件驱动和模型-视图-控制器(MVC)设计原则,便于创建动态网页和处理用户交互。 2. **数据库设计**:图书馆系统通常需要管理书籍信息、借阅记录、用户账户等数据,因此数据库设计是关键。可能使用了SQL Server或MySQL等关系型数据库,通过ADO.NET或Entity Framework进行数据访问,实现CRUD(创建、读取、更新、删除)操作。 3. **身份验证与授权**:为了确保系统安全,。内容来源于网络分享,如有侵权请联系我删除。另外如果没有积分的同学需要下载,请私信我。
《图书管理系统(基于ASP .NET)》是一款专为学习者设计的应用程序,旨在提供一个全面的图书管理平台。系统的设计采用ASP .NET技术,这是一款由微软开发的用于构建动态网站、web应用和web服务的强大工具。ASP .NET框架以其高效、安全和易于维护的特点,深受开发者的喜爱。 该系统包含了多个核心模块,这些模块覆盖了图书管理的主要功能。有图书录入模块,它允许管理员录入图书的基本信息,如书名、作者、出版社、ISBN号、分类等。图书查询模块提供给用户方便快捷的搜索功能,用户可以根据书名、作者、关键词等条件进行检索。此外,借阅与归还模块确保图书的流通管理,记录图书的借阅状态,提醒用户按时归还,并处理超期罚款等事务。 系统还具备用户管理模块,允许用户注册、登录、修改个人信息。对于权限管理,后台有专门的管理员角色,他们可以对用户进行操作,如分配权限、冻结或解冻账户。同时,系统的统计分析模块能够生成各类报表,如图书借阅量、热门书籍、用户活跃度等,这些数据对于图书馆运营决策有着重要参考价值。 在。内容来源于网络分享,如有侵权请联系我删除。另外如果没有积分的同学需要下载,请私信我。
本专刊的主要目的是帮助初学者系统化和结构化地掌握会计知识。我们采用思维导图的形式,将复杂的会计概念和流程进行有效的简化,旨在让学习者能够更清晰地理解这些内容,并增强记忆效果。通过视觉化的方式,读者不仅能够感受到会计知识的关联性,还能轻松掌握关键点,提升学习效率。无论是在学习新知识还是复习旧知识时,这种方法都能够为学习者提供极大的便利和帮助。
精选毕设项目-todolist,带简易后端
精选毕设项目-美食菜谱
精选毕设项目-地图定位
精选毕设项目-学富网家教电商平台
精选毕设项目-乐租租房工具
chromedriver-linux64_123.0.6296.0
永磁同步电机,基于扩展卡尔曼滤波算法无传感器仿真模型,s函数编写算法,基于matlab simulink搭建。 附参考资料
factoryio液位PID仿真程序 使用简单的梯形图编写,通俗易懂,起到抛砖引玉的作用,比较适合有动手能力的入门初学者。 软件环境: 1、西门子编程软件:TIA Portal V15(博图V15) 2、FactoryIO 2.4.0 内容清单: 1、FactoryIO中文说明书+场景模型文件 2、博图V15PLC程序(源码)。
comsol光学仿真 任意偏振态BIC,利用扭转光子晶体实现远场偏振的调控,包含能带,品质因子计算以及远场辐射偏振椭圆绘制
STM32使用技巧,实战应用开发小系统参考资料,源码参考。经测试可运行。 详细介绍了一些STM32框架的各种功能和模块,以及如何使用STM32进行应用开发等。 适用于初学者和有经验的开发者,能够帮助你快速上手STM32并掌握其高级特性。。内容来源于网络分享,如有侵权请联系我删除。另外如果没有积分的同学需要下载,请私信我。
内容概要:本文提出了一种数据驱动进化算法(ADE-GRNN)来优化风电场布局,旨在最大化风电场功率输出并减少计算时间。文中引入了自适应差分演化算法和通用回归神经网络来训练数据驱动模型,通过快速过滤低效候选解来提高求解效率。同时详细描述了风力发电机组的位置排布对功率产生成关键影响的因素如湍流效应以及不同算法(ADE、JADE、CLPSO)间的性能对比实验结果。研究表明,在多个评估指标方面,所提出的 ADE-GRNN 方法均表现出显著优势。 适合人群:对于希望深入理解智能算法在工程实践中特别是新能源领域的应用的研发人员和技术爱好者非常适合。 使用场景及目标:用于需要高效能解决复杂组合最优化问题的企业或项目组,特别是在涉及大规模风电场布局规划时的目标定位是提升能源转换率,降低成本消耗,提高运算速度。 其他说明:未来的研究可以进一步考虑更为复杂的风电场拓扑结构及更精确地模拟尾流效应,并探索三维空间下最优布局的可能性;此外还可以尝试不同的机器学习方法来稳定代理模型的表现。
电流计算方法:.docx
精选毕设项目-茶叶商城(含后端)
精选毕设项目-化妆品商城
chromedriver-linux64_123.0.6286.0