README.zh_CN
coding: utf-8
for conky-weather 4.1, 2018-9-10
by Careone
* 简介
根据深度论坛网友 madness 的一篇贴子，修改出了一个精简版的主题，
能显示日期，时间，自带天气（数据来自墨迹天气，还支持自动/手动更新天气功能）
原贴：› 深度乐园 › 深度茶社 › deepin利用conky打造一个炫酷的桌面
网址： https://bbs.deepin.org/forum.php?mod=viewthread&tid=148009&extra=&page=3
原作者： madness 2017-11-11
* 郑重声明：
非常感谢原作者 madness 的用心创作和付出！
* DEB 包同时也放到了我个人的 Sourceforge 页面，可供下载：
---------------------------------
DEB 安装包名称: conky-weather
下载地址：
https://sourceforge.net/projects/emacslocale/files/conky-weather/
---------------------------------
!!! 重要提示 !!!
---------------------------------
软件包安装完成后，需要做两件事情：
1. 以普通用户，运行命令 conky-weather.runonce 一次!
只需要运行一次即可！
主要作用：
* 替换/更新用户的 ~/.conkyrc 配置文件；
* 添加conky和Conky天气 (conky-weather) 的开机自启动项；
* 设定为每小时更新一次conky天气；
(更详细的说明，请查看 /etc/conky/themes/madness/README.zh_CN 文件)
作用：
* 自动替换并备份当前用户的 Conky 配置文件, 以支持 Conky 天气显示;
[ 命令: conky-weather-theme.enable ]
* 立即启动 Conky;
[ 命令: conky & ]
* 现在立即更新一次天气;
[ 命令: conky-weather-update ]；
* 设置 Conky 为开机自启动；
实现方式: 在目录 ~/.config/autostart/ 下添加自启动文件 90conky.desktop
同时在 ~/.profile 文件中加入 "conky &" 指令；
* 定时更新 Conky 天气（每小时更新一次）；
实现方式: 添加 crontab 计划任务，把 conky-weather-update 命令,
设定为每小时的第几分钟自动执行一次
* 每次开机后，立即自动更新一次天气；
实现方式: 在目录 ~/.config/autostart/ 下添加自启动文件
86conky-weather-update.desktop
* 附加功能：
** 如果不存在 conky-weather 配置文件: ~/conky/conky-weather.cfg，
则自动创建（文件内容包含有示例和说明）;
2. 在配置文件中，把conky天气的城市数据网页地址，修改为对应的地址：
配置文件: ~/conky/conky-weather.cfg
默认数据地址: https://tianqi.moji.com/ （数据来源：墨迹天气）
默认的城市: 北京
注：默认的配置文件 ~/conky/conky-weather.cfg 中,
有城市数据地址示例和说明，方便参考。
## 如何获得自己所在城市的天气页面地址？
## 方法： 在浏览器中，输入地址: tianqi.moji.com ，然后选择自己所在的省份，
## 城市（或者省级市，区），确定。这时浏览器的地址栏会变成类似这样的地址：
##
## https://tianqi.moji.com/weather/china/hunan/changsha
## https://tianqi.moji.com/weather/china/hunan/xx-county
## https://tianqi.moji.com/weather/china/beijing/haidian-district
## https://tianqi.moji.com/weather/china/beijing/beijing
## 含义：最后的三组英文字母，分别代表：
## china: 代表中国；
## hunan: 代表省份的汉语拼音。这里代表“湖南”省。
## changsha: 代表城市的汉语拼音。这里代表“长沙”市。
## xx-county: 代表xx县。county 是指“县”的意思。
## beijing/haidian-district: 代表：北京/海淀区。district 是指“区”的意思。
## 注：直辖市(如北京，上海，天津，重庆)如果不确定是在哪个区，也可直接
## 连写两次城市名，如: beijing/beijing 代表"北京/北京"
##
## 把浏览器中显示的网页地址，复制并保存为用户主目录下的
## conky/conky-weather.cfg 文件。
## 完整文件路径: ~/conky/conky-weather.cfg
## 或者: $HOME/conky/conky-weather.cfg
##
## 最后再以普通用户运行命令 conky-weather-update 更新天气即可!
---------------------------------
* DEB 软件包中自带了几个命令，作用如下：
1* conky-weather.runonce
安装完 DEB 软件包后，请以普通用户运行命令 conky-weather.runonce 一次!
只需要运行一次即可！
作用:
* 自动替换并备份当前用户的 conky 配置文件, 以支持 conky 天气显示;
* 设置 conky 为开机自启动；
* 定时更新conky天气（每20分钟更新一次）；
实际上，也相当于分别运行下面3个脚本命令：
2* conky-weather-theme.enable
更新/替换用户的conky配置文件 ~/.conkyrc (自动保留备份)
3* conky-weather-update
用于自动/手动更新Conky天气数据
4* conky-weather-add-crontab
用于添加自动更新天气的指令到 crontab (每20分钟更新一次)
---------------------------------
* conky-weather version 4.1 使用帮助
** 命令1: conky-weather -h
----
Usage: conky-weather
conky-weather [OPTION]
定时更新 conky 天气信息
Options:
--init, --runonce 初始化Conky天气。即为当前用户创建Conky天气的
默认配置文件，并进行 [开机自动启动] 和 [定时更新天气] 设置。
(等同于直接运行命令 conky-weather.runonce )
-i, --conkyrc 显示/修改 conky 的默认配置文件 ~/.conkyrc
-p, --ip2city 按IP地址定位城市, 并显示天气网址和城市名称(需要联网)。
提示：能定位到城市，但不能精确到区/县
-a, --auto-city-url
和 --ip2city 类似，但简化了内容，只显示生成的天气网址
-c, --city 启用 [自定义] 模式。即修改文件 ~/conky/conky-weather.cfg ,
加入某个特定城市的天气网页地址
-cw, --weather 启用conky天气主题（即更新或者替换 ~/.conkyrc 文件）。
相当于直接运行 conky-weather-theme.enable
-x15, -x2 与 -cw 选项作用类似，但改为用更大的字体显示，以适合
大屏幕。-x15 作用是字体放大1.5倍; -x2 是字体放大2倍。
-rm, --remove
[删除] Conky天气的个人自启动文件/自动运行指令代码
-ra, --remove-all
[全部删除] Conky天气的个人自启动文件/自动运行指令代码,
以及天气数据和其它相关文件
提示：如果只是想临时 [禁用] Conky天气，推荐使用 --remove 选项来卸载；
如果是 [不喜欢] Conky天气，请使用 --remove-all 选项来卸载；
-t, --todo 显示/修改要提醒的内容（即修改文件 ~/conky/todo.txt）。
说明：只显示文件内容的前 5 行
-x, --extra 显示更多辅助功能选项
-v, --version 显示版本信息并退出
-h, --help 显示帮助信息并退出
** 命令2: conky-weather -x
conky-weather 辅助功能和选项:
--color 默认文字颜色 [阴影颜色] [框线颜色]
使用指定的文字颜色/阴影颜色/框线颜色。需要指定1-3个颜色代码
例1：默认使用[绿色]文字:
--color green
或者 --color 00ff00
或者 --color 绿
例2：默认使用[绿色]文字, [蓝色]阴影:
--color green blue
或者 --color 00ff00 0000ff
或者 --color 绿 蓝
例3：默认使用[绿色]文字, [蓝色]阴影，[白色]框线:
--color green blue white
或者 --color 00ff00 0000ff ffffff
或者 --color 绿 蓝 白
-u, --auto 启用 [自动漫游] 模式。即按IP地址定位城市后，
再更新天气。默认使用这种模式。
-g, --logcity
启用 [城市备份] 功能。如果更新天气时发现城市地址有变更，
则自动备份新的天气网址到文件 ~/conky/conky-weather.autocity
-w, --weather-code
显示 Conky天气相关的指令代码。用户可以复制代码并
添加到自己的 ~/.conkyrc 文件中，来显示 Conky天气
---------------------------------
已知问题
* 版本 3.0，可能无法定时自动更新天气（但是可以在命令行手动运行
conky-weather-update 来即时更新天气）
----注：版本 4.0-1beta2 中，已经修复这一问题；
TODO 开发计划
* 合并多个命令到一个新的主程序 usr/bin/conky-weather, 通过使用命令
选项, 实现原程序的功能。包括：
+ usr/local/bin/conky-weather.runonce
+ usr/local/bin/conky-weather-theme.enable
+ usr/local/bin/conky-weather-add-crontab
说明：原来的 usr/local/bin/conky-weather-update 除了用于更新天气外，
只保留最常用的几个命令行选项（主要是出于兼容性和使用习惯考虑）
* 命令程序所在的路径, 从 usr/local/bin/ 转移到 usr/bin/;
**********************
* version 4.1, 2018-9-10, by Careone
* 更新：usr/bin/conky-weather 版本升级到 4.1；
* 更新：usr/bin/conky-weather-update 版本升级到 4.1；
主要更新内容：每次天气数据更新后，时间不再显示为 [今天 HH:MM更新]，
改为显示 [M月D日 HH:MM更新]。说明：日期的年月日取决于当前电脑设定的日期。
* version 4.0-1beta2, 2018-8-5, by Careone
* DEBIAN/postinst 自动安装脚本细节微调，同步更新了系统默认的Conky 天气
配置文件变量 CONKYRC_MINI 的路径和文件名；
旧： CONKYRC_MINI='/etc/conky/themes/madness/conkyrc_mini'
变更为：CONKYRC_MINI='/etc/conky/conky-weather/conkyrc'
* 更新：命令 usr/local/bin/conky-weather-update, 路径调整为
usr/bin/conky-weather-update; 并删除了大量参数选项，
只保留了 --runonce, --city, --conkyrc, --todo 这几个
常用选项（这些选项实际上是对主程序 usr/bin/conky-weather
的同名选项调用）；
* 修复：删除了 usr/bin/conky-weather, usr/bin/conky-weather-update 文件头第一行开头多余的空格，
解决了从版本3.0 到 4.0-1beta1 中，无法自动定时更新天气的缺陷。
（这是一个多余的空格引发的灾难！）
应为： [#!/bin/bash]
误写为：[ #!/bin/bash]
* version 4.0-1beta1, 2018-7-27, by Careone
* 更新：conkyrc 天气的主题配置目录和文件名，目录由旧版本的
etc/conky/themes/madness/ , 转移到 etc/conky/conky-weather/ 目录下；
原文件 conkyrc_mini 重命名为 conkyrc。同时添加了 conkyrc_x1.5 （字体放大1.5倍）
和 conkyrc_x2 (字体放大2倍) 这两种配置方案，以更好地适应大分辨率的电脑显示屏。
* 新增：命令 usr/bin/conky-weather, 及选项 -cw, -x15, -x2。作用：
conky-weather -cw : 相当于旧版中直接运行命令 conky-weather-theme.enable ;
conky-weather -x15 : 与选项 -cw 类似，但改为使用放大字体1.5倍的配置方案；
conky-weather -x2 : 与选项 -cw 类似，但改为使用放大字体2倍的配置方案；
* 更新：原 etc/conky/themes/madness/ 目录下的几个文件 README.zh_CN, ChangeLog,
路径转移到 usr/share/conky/conky-weather/ ;
* 修复：usr/share/conky/conky-weather/changeLog.zh_CN 中，版本3.0及更早版本的描述中的
几处文字错误和中英文标点排列混乱的问题；
* 添加 usr/share/conky/conky-weather/LICENSE 许可证文件，使用 BSD三言许可证发布；
* 更新：usr/local/bin/conky-weather-theme.enable, 简化为直接调用
usr/bin/conky-weather 的 -cw 选项；
* 其它代码微调和细节优化；
version 3.0, 2018-6-21, by Careone
* 更新 usr/local/bin/conky-weather-update (从版本 2.4 到 3.0):
+ 根据网友和用户的意见，添加卸载的功能选项 --remove 和 --remove-all,
作用：--remove 用于卸载程序前，手动清理当前用户的自启动指令和文件;
--remove-all 除了手动清理当前用户的自启动指令和文件，
还删除 ~/conky/ 目录下的conky天气的相关数据和文件;
* 新增：选项 --runonce 。等同于直接运行
usr/local/bin/conky-weather.runonce;
* 新增：选项 --extra 。用于显示附加功能参数的帮助信息；
* 新增：选项 --color 。用于设定默认文字的颜色。
说明：需要使用选项 --extra 才能看到本选项的帮助信息；
* 调整：选项 --help 中的部分内容，转移到 --extra 选项中；
* 更新：移除了 etc/conky/themes/madness/conkyrc_mini
文件开头的两行重复内容；
* 更新：usr/local/bin/conky-weather.runonce --> version 3.0;
(代码细节微调)；
* 更新：usr/local/bin/conky-weather-add-crontab --> version 3.0;
(代码细节微调)；
version 2.6, 2018-6-10, by Careone
* 更新 etc/conky/themes/madness/conkyrc_mini:
针对笔记本电脑的使用环境，添加了一行显示电池电量和剩余时间的代码：
${color #ffff00}电池: ${color}$alignr$battery [剩余时间 $battery_time]
作用：充电状态下，显示电量，以及充满电还需要的时间；
未充电时，显示电量，以及电池还可使用的剩余时间；
version 2.5-4, 2018-3-17, by Careone
* 显示效果细节优化：调整了 etc/conky/themes/madness/conkyrc_mini 中，
把三行 ${image} 数据，合并到同一行。调整后的效果：原来最下端的空白
区域高度，由原来的三行，减少到一行）；
version 2.5, 2018-3-16, by Careone
* 重新制作 DEB 软件包，添加了 conky-all 软件包依赖关系，
解决了不显示天气图片的缺陷；
* DEBIAN/postinst 和 postrm 自动安装脚本细节微调，
对 mv, cp 命令添加了 -u 选项；
* 版本更新: usr/local/bin/conky-weather-theme.enable 1.2 -> 2.5
+ 清除了部分过期代码;
+ 能更好地备份用户原有的 ~/.conkyrc 配置文件：
即在旧备份文件的文件名后面，添加备份时的日期和时间，如：
~/.conkyrc_2018-0316-214213
version 2.4.1, 2018-3-11, by Careone
* 托管地址转移到 Github 。
之前放在 SourceForge, 有时会无法正常下载和上传文件；
原项目网址:
https://sourceforge.net/projects/emacslocale/files/conky-weather/
新的项目网址:
https://github.com/kuiba1949/conky-weather/
* 授权协议使用BSD三言许可协议。为适应当前协议，移除了部分可能引起争议的文件:
** 移除了 usr/share/conky-weather/pixmaps/moji-weather/ 目录下的天气图片。
图片来自墨迹天气 https://tianqi.moji.com;
** 移除了 etc/conky/themes/madness/conkyrc 文件；
version 2.4, 2018-3-11, by Careone
* 修复: 天气图片无法显示的缺陷；
原因：程序无法自动创建用户目录 $PIC_DIR，即 ~/conky/moji-weather/，
另外自动下载天气图片的相关代码有缺陷（见 TAG 374）；
临时解决方案：手动创建目录 ~/conky/moji-weather/ 即可；
* 新选项: --auto 启用 [自动漫游] 模式。即按IP地址定位城市后，
再更新天气。默认使用这种模式。
* 新选项: --logcity 启用 [城市备份] 功能。如果更新天气时发现城市地址
有变更，则自动备份新的天气网址到文件 ~/conky/conky-weather.autocity
* 其它细节微调，代码优化；
version 2.3, 2018-3-08, by Careone
* 新增选项: --ip2city
根据IP地址，自动定位城市和天气网页地址；
定位过程中需要联网，IP地址数据来自 https://ip.cn
* 其它细节微调，代码优化；
version 2.2, 2018-3-05, by Careone
* 新增功能: 支持显示天气图片。图片目录位置:
/usr/share/conky-weather/pixmaps/moji-weather/；
* 新增功能: 支持在conky中显示提醒信息（实际操作即读取文件 ~/conky/todo.txt
的内容。最多只显示5行，防止文件行数太多，导致conky其它信息无法正常显示）;
* 更新: /usr/local/bin/conky-weather-update ver 2.1 -> 2.2
** 修复: 某些情况下，无法正常获取“城市/县城”字符数据，以及“明天”和“后天”的
天气数据无效的缺陷；
** 代码优化, 能更有效地解析天气数据;
** 新增更多选项：
--conkyrc 编辑conky配置文件 ~/.conkyrc
--city 修改要显示天气的城市的网页地址(即修改配置文件
~/conky/conky-weather.cfg);
--todo 可编辑要提醒的文字内容(即修改配置文件 ~/conky/todo.txt)；
* 更新: etc/etc/conky/themes/madness/conkyrc_mini
(注：本次未更新 etc/etc/conky/themes/madness/conkyrc )
version 2.1, 2018-3-03, by Careone
* 更新: etc/etc/conky/themes/madness/conkyrc_mini
** 支持显示最三天内的天气（旧版本只显示今天的天气），
** 同时调整了天气数据的文件保存规则：
现统一保存到单一的文件 ~/conky/conky-weather.db , 不再使用以前的多个文件：
~/.feed/feed_city, feed_ls, feed_xls, feed_wd ；
* 更新: etc/etc/conky/themes/madness/conkyrc
（更新规则参照上面的 conkyrc_mini）
* 更新: /usr/local/bin/conky-weather-update, 优化代码，并删除了部分过期的代码；
* 更新: /usr/local/bin/conky-weather-add-crontab
和 /usr/local/bin/conky-weather.runonce
天气更新频率由原来的1小时，变更为每20分钟更新一次；
version 2.0, 2018-2-07, by Careone
* 更新: DEB 格式软件包的源文件 DEBIAN/postinst
安装完成后，会弹窗提示进行最后的设置，来修改城市数据、添加自动启动、
自动更新天气;
* 更新: /etc/conky/themes/madness/conkyrc_mini
+ 时间显示中，不再显示秒数(即取消了 $time 的 ":%S" 值)；
+ 更新时间间隔(update_interval)从1秒调整为5秒；
* 把原 README.zh_CN 分拆为两个文件: ChangeLog.zh_CN 和 README.zh_CN;
* 更新: etc/conky/themes/madness/ChangeLog.zh_CN:
+ 修复了原 Changelog 部分，版本1.1，年份数字2018误写成20118的错误；
* 更新: usr/local/bin/conky-weather-update 2.0
添加 -w 和其它选项
* 更新: usr/local/bin/conky-weather-add-crontab 2.0
如果已存在 ~/conky/86conky-weather-update.cron 计划任务示例文件，
则直接使用这个文件，而不再是重新生成文件（取消无意义的文件写入操作）；
version 1.5, 2018-2-05, by Careone
* 更新: /etc/conky/themes/madness/conkyrc_mini
+ 微调了“年月日，星期几”的居中对齐的代码 ${alignc}位置（前移）。
之前的居中对齐代码的位置错误，无法实现居中效果；
* 更新: /usr/local/bin/conky-weather-update
+ 修复/优化了部分程序代码缺陷：
数组 feedfile[@] 内的值更正为 feed_xls (之前误写为 feed-xls.
即下划线'_'误写为连字符'-');
+ 修复了第139行附近清空数组文件时，文件名缺失目录路径 $FEED_DIR 的缺陷；
+ 微调了默认生成的配置文件 ~/conky/conky-weather.cfg 的内容，添加了对
直辖市（如“中国/北京/北京”格式）的天气数据地址示例；
* 更新: /usr/local/bin/conky-weather.runcone
+ 修复/优化了部分程序代码缺陷, 禁用了部分交叉的变量/数组定义和功能模块，
完全移交给命令 conky-weather-update 单独执行；
version 1.4.1, 2018-2-04, by Careone
* 更新: /etc/conky/themes/madness/conkyrc_mini
+ 城市名称的对齐方式调整：由默认的“左对齐”，调整为“居中对齐”；
* 更新: /usr/local/bin/conky-weather-update
+ 优化了部分程序代码和输出文字的排版对齐效果；
* 更新: /usr/local/bin/conky-weather.runcone
+ 优化了部分程序代码和输出文字的排版对齐效果；
+ 每一步操作完成后，都会暂停3秒，用户能更方便地看到
程序所做的具体内容；
version 1.4, 2018-2-03, by Careone
* 更新: /usr/local/bin/conky-weather-update
/usr/local/bin/conky-weather.runonce
+ 在这两个命令中，添加了开机自启动项
（开机后立即运行 conky-weather-update 更新一次天气）：
~/.config/autostart/86conky-weather-update.desktop；
+ 同时把 conky-weather.runonce 中预设的 conky 自启动项的
文件名由 conky.desktop 变更为 90conky.desktop;
+ 调整了这两个命令中的部分函数名和代码细节；
* 添加：图标文件 /usr/share/pixmaps/conky-weather-update.png ;
version 1.3, 2018-2-02, by Careone
* 变更：修改了个人自定义的城市天气地址页面文件的文件名及默认内容：
原配置文件: ~/conky/www_city.txt
新: ~/conky/conky-weather.cfg
* 更新: /usr/local/bin/conky-weather-update
缩短每次更新天气的所用的时间：从19秒缩短为2秒；
同时取消了部分频繁写入、读取天气数据文件的操作；
version 1.2, 2018-2-01, updated by Careone
* 新增: 用户可以在文件 ~/conky/conky-weather.cfg 中，输入指定城市/县城的
天气网页地址, 来显示对应城市/县城的天气;
* 添加: 文件 README.zh_CN ( /etc/conky/themes/madness/README.zh_CN );
* 添加: 命令 /usr/local/bin/conky-weather-theme.runonce
用于安装后自动更新/替换当前用户的 Conky 配置文件 ~/.conkyrc ,
并自动添加 conky 自启动运行、定时更新天气的指令（每小时更新一次）；
* 更新: /etc/conky/themes/madness/conkyrc_mini 配置文件，
现在 Conky天气中，会显示对应的城市名称；
* 更新: /usr/local/bin/conky-weather-update
* 更新: /usr/local/bin/conky-weather-add-crontab
------
* DEB 打包相关变更:
** 更新：在 control 文件中添加中文相关说明和使用方法；
** 更新：postinst 安装脚本。安装完成后，会用 Conky 天气的配置文件
（右上角对齐方式）/etc/conky/themes/madness/conkyrc_mini ，
替换 conky 自带的配置文件 /etc/conky/conky.conf .替换之前
会自动备份原 conky.conf 为 conky.conf.orig;
** 添加：postrm 安装脚本。卸载完成后，会自动用备份文件 conky.conf.orig
恢复 conky 自带的配置文件 /etc/conky/conky.conf；
version 1.1, 2018-1-31
原作者: madness, 2017.11 - 2018
修改/DEB打包人: Careone, 2018.1.31
* 能以 conky 的方式，在屏幕右上角显示以下信息：
+ 时间（时/分/秒）；
+ 日期（年月日，星期几）；
+ 天气所在的城市，省份；
+ 天气相关数据，天气数据的更新时间；
+ 用户操作系统名称；
+ 用户操作系统内核版本；
+ 已开机运行时间（对笔记本电脑比较实用）
* 添加：conky 图标文件 /usr/share/pixmaps/conky.png ;
* 添加：conky 快捷启动方式文件 /usr/share/applicarions/conky.desktop ;
Download Latest Version
68-cheLiang-jiaYouJiLuBiao.zip (31.4 kB)
