背景
gitbook (https://app.gitbook.com/)
最初,我使用GitBook进行记录。免费版功能已能满足日常需求,并且支持直接使用Markdown语法进行编辑。然而,访问时需要通过特殊方式(科技)。GitBook的主要优点是其灵活的记录和排版功能,可以将内容整理成书籍形式并分享。例如,你可以参考这个示例:示例。编辑时,GitBook允许多层级内容结构,还提供许多实用功能,例如支持多种内容类型的直接嵌入,甚至包括网页URL。此外,你还可以在页面中嵌入许多实用的内容。然而,我们还有一个独立的博客系统,这导致两者之间不兼容。
GitBook只能在使用科技的情况下访问链接。而且,如果从博客页面访问,会跳转到GitBook的链接,相当于在两个不同的网站之间切换,用户体验非常差。因此,我们需要将GitBook内容本地化,并与博客系统兼容,实现一端访问。
总体设计
首先,我们需要准备一台开发机(例如Mac Mini,或者其他合适的设备),以及一台阿里云服务器用于做代理。通过使用frp进行内网穿透,使得本地开发机可以通过公网进行访问(在此过程中,请务必注意本地的安全设置)。
设计细节
gitbook
将GitBook与GitHub关联起来,当写作完成后,可以同步到GitHub,方便进行版本管理。你也可以在本地编辑内容,然后推送到GitHub,这样会自动同步到GitBook。当然,我们的博客内容也存储在GitHub上,并通过代理进行转发。同样地,GitLab也可以实现这些功能。
github
在GitHub上创建相应的仓库和分支,然后执行上一步的内容同步。接下来,为该仓库添加一个Webhook。这里添加的Webhook URL将会用于后续配置的Open API。
具体步骤如下:
- 创建仓库和分支
- 在GitHub上创建一个新的仓库,并根据需要创建对应的分支。
- 将本地的GitBook内容推送到这个仓库中。
- 添加 Webhook
- 进入GitHub仓库的设置页面,选择“Webhooks”。
- 点击“Add webhook”按钮。
- 在“Payload URL”字段中,填写后续配置的Open API URL。
- 选择“Content type”为
application/json
。 - 配置其他选项后,点击“Add webhook”保存。
这些步骤将确保GitHub仓库中的内容可以通过Webhook进行自动化处理,进一步与GitBook和博客系统集成。
- Push 事件:当有人向仓库推送代码时触发。
- Pull Request 事件:当有人创建、更新、合并或关闭 pull request 时触发。
- Issue 事件:当有人创建、更新、关闭或重新打开 issue 时触发。
- Comment 事件:当在 commit、issue、pull request 上添加评论时触发。
- Release 事件:当发布新版本时触发。
- Repository 事件:当仓库被创建、删除、公开、私有化、重命名或添加、删除标签时触发。
- Status 事件:当 Git 提交状态发生更改时触发(例如,CI/CD 管道完成)。
- Watch 事件:当用户开始或停止关注仓库时触发。
- Fork 事件:当仓库被 fork 时触发。
- Membership 事件:当团队中的成员关系发生更改时触发。
- Deployment 事件:当部署被创建或更新时触发。
- Deployment Status 事件:当部署状态发生更改时触发。
- Branch Protection 规则更改事件:当分支保护规则被添加、更新或删除时触发。
- Check Suite 事件:当检查套件被创建、请求或完成时触发。
- Check Run 事件:当检查运行被创建、更新或完成时触发。
- Create 事件:当在仓库中创建分支或标签时触发。
- Delete 事件:当在仓库中删除分支或标签时触发。
- Public 事件:当仓库从私有变为公开时触发。
- Private 事件:当仓库从公开变为私有时触发。
…以及其他更多类型的事件。
mac & aly
当考虑购买轻量级服务器来托管应用时,特别是在实际服务运行于本地Mac Mini的情况下,我们的需求不需要高性能的服务器。如果不打算使用公网IP,可以通过购买域名来简化访问管理。
frp
一、frp简介
1.frp是什么
FRP 是一种用于实现内网穿透的工具。内网穿透是一种技术,允许你从互联网访问位于私有网络(内网)中的计算机、服务器或设备,即使它们位于防火墙或路由器后面。
FRP 使用客户端-服务器架构,其中客户端位于内网,服务器位于公共网络中(例如互联网)。
项目地址:https://github.com/fatedier/frp/releases
2.为什么使用 frp ?
使用FRP进行内网穿透有几个优势和原因,特别是在需要远程访问位于私有网络内的设备或服务时:
- 绕过网络限制和防火墙: 很多公司、组织和家庭网络都设置了防火墙和网络限制,以保护内部网络安全。使用FRP可以绕过这些限制,从外部网络访问内部设备,而无需在防火墙上进行复杂的端口映射设置。
- 安全性和加密: FRP支持数据的加密传输,从而确保通过公共网络传输的数据是安全的。这对于保护敏感信息和隐私非常重要。
- 简化网络配置: 使用FRP可以避免手动配置复杂的端口映射和路由设置,这在某些情况下可能会很繁琐和容易出错。FRP提供了更简化的方法来实现内网穿透。
- 动态 IP 地址处理: 如果你的内部网络中的设备使用动态分配的IP地址,使用FRP可以消除由于IP地址变化而导致的连接问题。FRP通过与服务器建立稳定的连接,无论IP地址是否变化,都能够维持通信。
- 跨平台支持: FRP在多个操作系统和平台上都有支持,这使得它适用于不同类型的设备和应用。
- 远程维护和访问: 使用FRP,你可以轻松地远程访问和维护内部网络中的设备,无论你身在何处。这对于IT支持、设备管理和远程故障排除非常有用。
- 访问内部服务: 如果你运行着一些需要从外部网络访问的服务(如网站、数据库等),使用FRP可以方便地使这些服务对外开放。
需要注意的是,使用内网穿透工具时要确保安全性和隐私,以避免未经授权的访问。另外,选择正确的工具并正确配置它是确保成功实现内网穿透的关键。
通过使用 FRP,你可以实现安全且受控的内网穿透,允许远程访问内部服务,而无需将内网设备暴露在公共网络中。
请注意,由于技术和软件可能会不断演进,建议在使用任何工具之前查阅最新的文档和教程以获取准确的设置和配置信息。
3.基本原理
- 在带有公网ip的云服务器上部署frp的服务端frps;
- 在需要穿透的内网服务器上部署frp的客户端frpc;
二、前置环境准备
服务端和客户端使用的都是同一份文件,只是配置文件和启动文件不同。因此只需要下载一份文件,将其上传到各个服务器即可。
1.下载解压
下载地址:
https://github.com/fatedier/frp/releases
解压:
tar -xvf frp_0.44.0_linux_amd64.tar.gz # 解压缩
mv frp_0.44.0_linux_amd64 frp # 重命名文件夹为frp
2.目录解读
- frpc:客户端可执行程序
- frpc_full.ini:客户端所有配置项(可以在此文件查看frp的所有的配置项)
- frpc.ini:客户端配置项
- frps:服务端可执行程序
- frps_full.ini:服务端所有配置项(可以在此文件查看frp的所有的配置项)
- frps.ini:服务端配置项
- LICENSE:许可证
三、服务端配置
服务端需部署在带有公网ip的服务器上,最好是云服务器。frp对于云服务器的配置要求不高,类似2C2G的入门级云服务器即可。而且目前各大厂商都在搞活动,入门级云服务器一年才50元左右。
1.配置服务端(阿里云)
为避免误操作,可以删除客户端相关的文件及配置
rm -fr frpc* # 删除所有客户端相关的文件及配置
cp frps.ini frps.ini.bak # 备份原始配置文件
编辑配置文件:frps.ini
[common]
bind_port = 7000
token = U4ZvrO/.M]Wp{D;@[u;vUMZ5es9&)}(
# vhost_http_port = 18888
# tcp_mux = false
# frp管理后台端口,请按自己需求更改
dashboard_port = 7500
# frp管理后台用户名和密码,请改成自己的
dashboard_user = admin
dashboard_pwd = password
enable_prometheus = true
# frp日志配置
log_file = /home/frp/log/frps.log
log_level = info
log_max_days = 3
./frps -c frps.ini # 启动服务端
2.开通安全组
若公网服务器是在阿里云、百度云等云服务器上的,则需要在安全组中为frp开通指定的端口号,如:7000是frp服务默认端口号、7500是在frps.ini配置文件中指定的dashboard_port、其他的则是需要映射到内网服务器的端口
3.访问dashboard
访问地址:http://..**:7500/
账号密码:admin、password(对应配置文件中的dashboard_user与dashboard_pwd)
4.将frps添加为本地服务(可选)
也可以将frps添加为本地服务,具体步骤如下:
① 服务端新建文件:frps.service
内容如下:
[Unit]
Description=frps service
After=network.target syslog.target
Wants=network.target
[Service]
Type=simple
ExecStart=/home/frp/frps -c /home/frp/frps.ini
[Install]
WantedBy=multi-user.target
② 创建配置文件目录并复制文件
mkdir -p /etc/frp
cp frps.ini /etc/frp/
cp frps /usr/bin/
cp frps.service /usr/lib/systemd/system/
③ 配置自并启动客户端服务
systemctl enable frps # 允许自启动
# 执行成功会提示“Created symlink /etc/systemd/system/multi-user.target.wants/frps.service → /usr/lib/systemd/system/frps.service.”
systemctl start frps # 启动客户端服务
若更改了frps.service,则需使用“systemctl daemon-reload”命令重新加载配置。
三、客户端配置
1.配置客户端
编辑客户端配置文件frpc.ini
[common]
server_addr = .xxx.xxx.xxx # 服务端所在的公网ip地址
server_port = 7000 # 服务端默认端口号,与服务端配置文件保持一致
token = e10adc3949ba59abbe56e057f20f883e
# 去掉速度限制
tcp_mux = false
# [sample]
# type = tcp # 注意:这个地方一律填写tcp
# local_ip = 0.0.0.0 # jira所在内网服务器的ip地址
# local_port = 8088 # 本地访问端口号
# remote_port = 8088 # 映射到云服务器的端口号
[vnc]
type = tcp
local_ip = 0.0.0.0
local_port = 5900
remote_port = 35900
use_encryption = true
use_compression = true
[ssh]
type = tcp
local_ip = 0.0.0.0
local_port = 22
remote_port = 322
[test]
type = tcp
local_ip = 0.0.0.0
local_port = 4000
remote_port = 4000
2.启动客户端
./frpc -c frpc.ini # 启动客户端
3.云服务器安全组添加端口号
安全组中添加remote_port端口号
4.访问HTTP服务
此时则可以通过公网IP+内网端口访问指定服务,如下图所示,访问的是内网服务器的服务。
5.查看dashboard连接记录
客户端启动成功,通过代理访问后,可以看到dashboard的Proxies-TCP中记录了连接信息:
6.将frpc服务加为本地服务(可选)
要实现macOS下程序的自启动,很多人都知道在“设置” - “用户和群组”中设置和取消开机启动,但这里要说的是另外一种方式,那就是launchd的方式,通过在launchd下编写plist启动文件实现FRP带参数启动。这里要啰嗦两句,在launchd下其实有两种实现程序自启的方式
1.如果需要 root,并且是需要用户登陆后才能运行,把 plist 放在 /Library/LaunchAgents/\ 2.如果需要 root,并且不需要用户登陆后都能运行,把 plist 放在 /Library/LaunchDaemons/
怎么理解呢,第一种就是系统启动后,你不登录到桌面,程序就不会在后台启动,类似于Windows下的开始菜单里的startup。第二种就是系统启动后,程序也随系统在后台启动,不管用户是否登录桌面,类似于Windows下的系统服务。你需要哪种方式让程序自启,自行选择第一种或者第二种。
出于安全的考虑或者说被迫害妄想症作怪 我不想完全把我的macOS暴露出去,我只选择了在/Library/LaunchAgents/创建plist
sudo vim ~/Library/LaunchAgents/frpc.plist
让我们用上面的命令创建FRP的启动文件frpc.plist,并用vim编辑它,你当然也可以用你自己喜欢的编辑器编辑
<?xml version=”1.0” encoding=”UTF-8”?>\ <!DOCTYPE plist PUBLIC -//Apple Computer//DTD PLIST 1.0//EN\ http://www.apple.com/DTDs/PropertyList-1.0.dtd >\ \ \ \Label\ \frpc\ \ProgramArguments\ \ \pwd**/frpc\ -c\ \pwd/frpc.ini**\ \ \KeepAlive\ \ \RunAtLoad\ \ \ \
将上面一段代码粘贴到frpc.plist里,粗体字部分请修改为你的frpc和frpc.ini的真实路径,千万别照抄作业哦,老师会发现的
最后,在终端输入下面的两段命令给frpc.plist赋予权限,并加载配置到系统使配置生效
sudo chown root ~/Library/LaunchAgents/frpc.plist\ sudo launchctl load -w ~/Library/LaunchAgents/frpc.plist\
好了,现在你可以重启系统,然后就会发现FRP客户端已经可以随系统自启
打开活动监视器,可以看到frpc的后台进程
如果某一天你后悔了,不想让它自启了,只要在终端里输入下面的命令,下次FRP客户端就不会跟随你的系统自启了
sudo launchctl unload -w ~/Library/LaunchAgents/frpc.plist
四、常见问题及解决
1.客户端配置http转发启动服务报错
若在客户端配置文件中配置了http转发,启动客户端服务时发生如下报错:
【原因】:服务端配置文件frps.ini中未配置vhost_http_port
【解决办法】:
① 服务端配置文件frps.ini的[common]中添加vhost_http_port
[common]
# frp监听的端口,默认是7000,可以改成其他的
bind_port = 7000
# 授权码,请改成更复杂的,这个token之后在客户端会用到
token = e10adc3949ba59abbe56e057f20f883e
# 开启HTTP
vhost_http_port = 8088
② 客户端配置文件frpc.ini中添加custom_domains
[web]
type = http
local_ip = 192.168.1.211 # 内网本机ip
local_port = 8088 # 本地服务端口号
remote_port = 8088 # 映射到的公网服务器端口号
custom_domains = 服务端所在的公网ip
③ 配置后重新启动客户端服务
./frpc -c frpc.ini
注意事项:
1、若要直接在客户端配置文件中配置http代理,则服务端配置文件frps.ini中必须配置vhost_http_port;
2、若在客户端配置文件中配置http代理:type = http,则必须在底部带上custom_domains=xxx.xxx.xx.xx;
2.配置代理多HTTP
上述问题1的配置方法,似乎只能代理访问一个端口的http,即使客户端配置文件frpc.ini中指定了多个type=http的 [web] 项,但因为服务端配置文件frps.ini中只能指定一个vhost_http_port=xxx,所以此方法最终还是只能代理访问一个http的服务,即vhost_http_port端口号对应的那个http。
【解决方法】:
参考:
服务端配置文件frps.ini中不需要配置vhost_http_port,直接在客户端配置文件frpc.ini中配置多个 [web] 项,即要代理的HTTP即可,其中type=tcp,也不用指定custom_domains。配置示例如下:
[common]
server_addr = 180.xx.xx.xx
server_port = 7000
token = e10adc3949ba59abbe56e057f20f883e
# 去掉速度限制
tcp_mux = false
[jira]
type = tcp
local_ip = 192.168.1.211
local_port = 8088
remote_port = 8088
[gitlab]
type = tcp
local_ip = 192.168.1.211
local_port = 8081
remote_port = 8081
小结
以上是利用frp实现内网穿透的完整流程。在这个过程中,无需在各个访问端设备(如手机、PC、平板)安装frp客户端,只需在公网服务器上安装frp服务端,并在需要被代理转发的内网服务器上安装frp客户端,并正确配置各个服务的端口号。这样一来,所有用户可以在需要时通过手机、PC或平板随时随地访问内网服务。
另外,网络安全问题同样需要高度重视。由于内网穿透服务本身带有一定风险,建议在公网服务器和内网服务器上都开启防火墙,并根据需求临时开放必要的端口。此外,确保服务器的登录密码足够复杂和安全,以防止不明访问和潜在攻击。
Open API
你可以选择使用任何一种编程语言开发一个接口作为GitHub webhook的请求地址。开发完成后,需要将该接口的URL配置到GitHub webhook中。此外,你还需要在本地和Aly(可能是指阿里云)两个地方配置frp,以便将该接口的API接口暴露出去。
接口的代码逻辑很简单:启动服务,监听一个接口,当接收到请求时开始执行相应的逻辑。
api
使用fastapi框架,快速部署。https://fastapi.tiangolo.com/advanced/openapi-webhooks/
import os
import time
import uvicorn
from pydantic import BaseModel
from github_webhooks import create_app
from github_webhooks.schemas import WebhookCommonPayload
from fastapi import FastAPI, Query
# app = FastAPI()
app = create_app(secret_token='*******')
# WebhookCommonPayload is based on pydantic.BaseModel
class PullRequestPayload(WebhookCommonPayload):
class Pull(BaseModel):
title: str
url: str
action: str
@app.get("/github_webhook")
async def read_root():
return {"Hello": "World"}
# push动作触发
@app.hooks.register('push', WebhookCommonPayload)
async def handler(payload: WebhookCommonPayload) -> None:
"""
sender=User(id=, type='', login='') repository=Repository(id=, name='', full_name='', fork=False, url='', owner=User(id=, type='User', login='')) organization=None
"""
name = payload.repository.name
print(name)
if __name__ == '__main__':
uvicorn.run("main:app", host="0.0.0.0", port=****
, log_level="info", reload=True)
local gitbook
根据自己的场景开发,gitbook build ./ ./$1 编译为电子书,gitbook pdf ./ 编辑为pdf格式。在web端转编译是需要会员才可以的。
1.node 版本 v10.23.0
2.修改node镜像源为淘宝
npm config set registry https://registry.npm.taobao.org
校验
npm config get registry
3.安装gitbook
sudo npm install -g gitbook
sudo npm install -g gitbook-cli
执行gitbook -V查看版本
4.安装calibre-ebook
https://calibre-ebook.com/download_osx
配置 ~./bash_profile
# gitbook export pdf app
export EBOOK_PATH=/Applications/calibre.app/Contents/MacOS
export PATH=$PATH:$EBOOK_PATH
执行
source ~./bash_profile
校验版本
ebook-convert --version
5.导出pdf
# 生成 `pdf` 文件并输出 `debug` 级别日志
$ gitbook pdf ./ ./myBook.pdf --log=debug
# 生成 `epub` 文件并输出 `debug` 级别日志
$ gitbook epub ./ ./myBook.epub --log=debug
# 生成 `mobi` 文件并输出 `debug` 级别日志
$ gitbook mobi ./ ./myBook.mobi --log=debug
local hexo
source ~/.bash_profile
nvm use 18.17.0
cd $ProjectsPath/hexo
hexo g
echo "hexo g success"
hexo d
echo "hexo d success"
kill $(lsof -t -i:4000)
hexo s &
echo "hexo done"
启动 shell
source ~/.bash_profile
cd $ProjectsPath/hexo/
hexo s &
cd /
nvm use 10.23.0
cd $ProjectsPath/gitbook/interview/
gitbook serve --port 4001 \&
cd $ProjectsPath/github_webhook/
workon github_webhook
python main.py
高可用 supervisor
如果服务因为电脑重启或断电等问题而中断,可以使用进程管理工具Supervisor来确保服务的持续运行。
Mac环境安装和使用 supervisor
supervisor 用于管理自定义任务进程,可配置服务自动重启等多种功能,方便用户的计划任务管理。
安装
推荐采用 brew 包管理工具进行安装:
brew install supervisor
如果通过pip进行安装,需要重点关注pip所在的python环境,是处于本机系统下还是在conda env中。\ 不同环境下,supervisor的配置文件位置和参数有差异,容易导致问题。
检查是否安装成功:
% brew info supervisor
Last login: Thu Aug 24 22:18:25 on ttys002
➜ ~ brew info supervisor
==> supervisor: stable 4.2.5 (bottled), HEAD
Process Control System
http://supervisord.org/
/opt/homebrew/Cellar/supervisor/4.2.5 (951 files, 13.7MB) *
Poured from bottle using the formulae.brew.sh API on 2023-08-24 at 21:40:27
From: https://github.com/Homebrew/homebrew-core/blob/HEAD/Formula/s/supervisor.rb
License: BSD-3-Clause-Modification
==> Dependencies
Required: python@3.11 ✔
==> Options
--HEAD
Install HEAD version
==> Caveats
To start supervisor now and restart at login:
brew services start supervisor
Or, if you don't want/need a background service you can just run:
/opt/homebrew/opt/supervisor/bin/supervisord -c /opt/homebrew/etc/supervisord.conf --nodaemon
==> Analytics
install: 371 (30 days), 1,001 (90 days), 1,962 (365 days)
install-on-request: 367 (30 days), 997 (90 days), 1,958 (365 days)
build-error: 0 (30 days)
其默认配置文件位置:/opt/homebrew/etc/supervisord.conf
配置
这里首先说明一下,有不少文章说明是按照如下方式生成supervisord配置文件:
echo_supervisord_conf > /usr/local/etc/supervisord.ini
但是本文实践过程中,不需要这一步骤,安装完成后即自动存在supervisord.conf配置文件。\ 接下来,我们直接打开并修改配置文件。
启用http服务
打开监听TCP socket,启动inet的http服务。这个模块默认是未开启状态,打开后可通过web界面的方式管理子进程。只要将每行首位的分号;字符去掉即可。
[inet_http_server] ; inet (TCP) server disabled by default
port=127.0.0.1:9000 ; ip_address:port specifier, *:port for all iface
username=user ; default is no username (open server)
password=123 ; default is no password (open server)
查看 supervisord全局配置
在[supervisord]
部分,可看到logfile等各类配置参数,一般情况下保持默认即可。
修改 supervisorctl配置
supervisord 与 supervisorctl 之间是服务端与客户端的关系,因此,需要配置如下:
[supervisorctl]
;serverurl=unix:///opt/homebrew/var/run/supervisor.sock ; use a unix:// URL for a unix socket
serverurl=http://127.0.0.1:9000 ; use an http:// url to specify an inet socket
username=user ; should be same as in [*_http_server] if set
password=123 ; should be same as in [*_http_server] if set
;prompt=mysupervisor ; cmd line prompt (default "supervisor")
;history_file=~/.sc_history ; use readline history if available
这里服务端url和账户信息,要与前面 [inet_http_server]的配置保持一致。
编写 program任务配置
supervisord.conf的结尾处,定义了如何管理自定义配置文件:
; The [include] section can just contain the "files" setting. This
; setting can list multiple files (separated by whitespace or
; newlines). It can also contain wildcards. The filenames are
; interpreted as relative to this file. Included files *cannot*
; include files themselves.
[include]
files = /opt/homebrew/etc/supervisor.d/*.ini
因此,不推荐直接在 supervisord.conf中编写 program,而应该按照如上include说明,在同级目录下创建一个文件夹 supervisor.d,然后将自己的任务配置文件放在该文件夹下。
mkdir /opt/homebrew/etc/supervisor.d
touch github_webhook.ini
子进程配置项主要包括:
- program: 设置子进程的名称,也即web界面中展示的进程名称,不允许重复。
- command: 启动子进程的命令行
- directory: 执行的项目目录
- stdout_logfile: log日志输出文件路径,必须事先创建好
配置示例:
[program:github_webhook]
command=sh /Volumes/SDD/MyFile/Projects/github_webhook/run.sh
directory=/Volumes/SDD/MyFile/Projects/github_webhook
autostart=false
startsecs=5
stdout_logfile=/Volumes/SDD/MyFile/Projects/logs/github_webhook/supervisor.log
开始运行
启动 supervisor
supervisord -c /opt/homebrew/etc/supervisord.conf
进入 web后台管理页面,浏览器输入:http://127.0.0.1:9000
,按照提示输入前面配置的用户名密码。\ 登录成功后,即可通过web界面来操作已经配置的子进程。
命令行管理
除了通过web页面进行任务进程的管理,也可使用 supervisorctl 命令进行管理。\ 常用命令如下:
supervisorctl
#关闭所有任务
supervisorctl shutdown
# 启动某个进程
supervisorctl start programxxx
# 重启某个进程
supervisorctl restart programxxx
# 停止全部进程 注:start、restart、stop都不会载入最新的配置文件
supervisorctl stop all
# 载入最新的配置文件,停止原有进程并按新的配置启动、管理所有进程。
supervisorctl reload
# 根据最新的配置文件,启动新配置或有改动的进程,配置没有改动的进程不会受影响而重启。
supervisorctl update
查看执行的日志
supervisorctl
tail 「name」 stderr
brew安装的重启命令
brew services start supervisor
关闭supervisorctl密码,把图中的注释即可
日志查看
LogTail软件,直接查看supervisor的日志就可以。
- Post link: https://yanxiang.wang/%E8%87%AA%E5%8A%A8%E5%8C%96%E9%83%A8%E7%BD%B2blog/
- Copyright Notice: All articles in this blog are licensed under unless otherwise stated.