opensource.microsoft.com
opensource.microsoft.com网站是一个简单、事实性的网站,分享有关微软开源计划、我们支持的开源生态系统以及参与项目和了解更多信息的机会。
该网站由Jekyll生成,Jekyll是一个流行的用Ruby实现的开源静态网站生成器(GitHub Pages就是由Jekyll提供支持)。它部署在Microsoft Azure的Linux Azure Kubernetes Service (AKS)集群中,并且还使用了Azure Front Door和Azure CDN。动态数据通过用TypeScript实现的Node.js后端获取。
该网站由微软开源项目办公室(OSPO)创建,OSPO是One Engineering System (1ES)团队的一部分。我们于2020年8月推出了这个网站,取代了之前的过时版本。我们预计微软团队将对网站进行更新和贡献,以展示新的有趣项目、更新精选博客文章,并改进计划和生态系统页面。
我们目前没有计划为网站添加截然不同的部分,或将其作为博客文章或其他内容的"唯一真实来源"。我们能够接受一些协调的贡献或建议,但请在开始新功能之前在issues中进行协调,因为该网站有一系列要满足的要求,如符合WCAG 2.1无障碍标准,并部署到微软的云平台。
网站的主要导航包括:
- 主页概览
- 参与其中
- 项目
- 生态系统
- 我们的计划
其他内容包括:
- 工作机会(外部链接)
- 博客(外部链接)
- 行为准则文本
- 社区资源
- 关于支持该项目的开源软件的"感谢"页面
- OpenAtMicrosoft Twitter
- 本仓库
贡献
行为准则
本项目采用了微软开源行为准则。 更多信息请参见行为准则常见问题或 联系opencode@microsoft.com提出任何其他问题或意见。
CLA
本项目欢迎贡献和建议。大多数贡献需要你同意一份贡献者许可协议(CLA),声明你有权并确实授予我们使用你的贡献的权利。详情请访问https://cla.opensource.microsoft.com。
当你提交拉取请求时,CLA机器人会自动确定你是否需要提供CLA,并适当地标记PR(例如,状态检查、评论)。只需按照机器人提供的说明操作即可。你只需要在所有使用我们CLA的仓库中执行一次这个操作。
贡献场景
感谢你有兴趣为https://opensource.microsoft.com网站做出贡献。请确保在开始拉取请求之前,先以issue的形式沟通任何贡献想法。我们很乐意看到如何最好地让你参与进来。
我们很高兴这个网站是开源的(因为一个关于开源的网站应该是开源的)。
作为托管在microsoft.com的面向公众的网站,我们可能无法接受对该网站的一般贡献,因此你的拉取请求可能会被关闭而不被合并,即使它很棒,我们也可能无法为任何此类决定提供完整的背景。
感谢你的理解。
商标
本项目可能包含项目、产品或服务的商标或标志。微软商标或标志的授权使用必须遵循 微软商标和品牌指南。 在本项目的修改版本中使用微软商标或标志不得引起混淆或暗示微软赞助。 任何第三方商标或标志的使用都受制于这些第三方的政策。
遥测
默认情况下,本项目不包含遥测;但是,GitHub Actions可能会生成网站的生产版本而不做修改。
当Jekyll构建环境设置为微软的生产环境名称 - "opensource.microsoft.com" 时, 微软的标准cookie合规和分析代码会被包含在网站中,以连接Application Insights。
- 数据收集。该软件可能会收集有关你和你使用该软件的信息,并将其发送给微软。微软可能会使用这些信息来提供服务并改进我们的产品和服务。你可以按照仓库中的说明关闭遥测功能。该软件中还有一些功能可能使你和微软能够从你的应用程序用户那里收集数据。如果你使用这些功能,你必须遵守适用法律,包括向你的应用程序用户提供适当的通知,以及微软隐私声明的副本。我们的隐私声明位于https://go.microsoft.com/fwlink/?LinkID=824704。你可以在帮助文档和我们的隐私声明中了解更多关于数据收集和使用的信息。你使用该软件即表示你同意这些做法。
开发
使用Codespaces进行开发
在你的Codespace中运行这些命令:
bundle
npm install
bundle exec jekyll serve
然后编辑器应该会指示你去转发的端口进行测试。
本地开发
确保你有可用的Ruby、Node.js和Gulp。
bundle
npm install
gulp
bundle exec jekyll serve
Dockerfile
可用于托管静态网站的本地nginx
版本,
但是在本地运行时动态网站功能不可用,并且
目前容器中不运行Gulp。
GitHub Actions
本仓库使用GitHub Actions用于多个目的。
构建
从main
分支的主要构建创建网站的静态版本并将其存储为构件。这是
使用特定于此构建环境的Docker容器完成的,包括Ruby Gems、
Node包等。
拉取请求
如果项目维护者批准,可以配置单独的暂存环境来使用此网站的版本,
使用包含短语/startContentBuild
的评论。