# coding: utf-8
# dlist 版本 0.2
# 最后更新: 2014-09-27
---------------------------------------------------------------------
dlist 使用说明
---------------------------------------------------------------------
目录
------------------------
1. 应用场景和功能
2. 快递/物流行业相关术语解释
3. 程序实现和容错设计
4. LRC歌词文件格式解析(略)
5. 命令操作示例(未完成)
6. 已实现的功能
7. 项目规划和开发进度
8. 字典数据软件包命令规则
9. 如何自己编写和维护字典文件(未完成)
10. 常见问题(FAQ)
11. 相关链接
12. 版权
1. 应用场景和功能
-------------------------
* dlist 对于物流/快递行业有什么用
** 功能101 按关键字分配投递员
** 功能102：把订单文字信息，当成歌词文件来查看
把划分好线路的地址，订单，收件人信息等内容，转换为 MP3 歌曲的
LRC 歌词文件格式，再随便找一个（或者复制一个） MP3 歌曲文件。只要保证
MP3 歌曲和 LRC 歌词/字幕文件的主文件名相同，就可以实现在播放 MP3 的时
候，暂停播放，再手动移动歌词的时间和播放位置，也能方便地查看订单信息，特别
是可以随意上下滚动功能，比常用的电子书软件的翻页功能要方便得多。
另外还可以利用 MP3 的“桌面歌词”功能，在手机/电脑/平板电脑的主背景下，
显示歌词/字幕内容。这一点是一般的电子书软件难做到的。
2. 快递/物流行业相关术语解释
-------------------------
** 201 订单相关编号
*** 订单编号（也称“订单号”）
*** 发货单号
*** 包裹号
** 202 订单类型
*** 送货单
*** 退货单
*** 换货单
3. 程序实现和容错设计
-------------------------
* 关键字的搜索和重复性
*** 编程思路说明
我目前的编程环境，是在 Debian 7.6 下，用 bash 编程语言来实现的。
主要使用了下面几组命令:
**** 命令1： head -1 '1d'
功能：显示文件的第一行。主要用于提取 CSV 电子表文件的标题行
**** 命令2： sed -i '1d'
功能：删除文件的第一行。主要用于删除 CSV 电子表文件的标题行，剩下内容的
就是纯数据行。-i 参数表示对文件进行保存。如果不使用 -i 参数，作用就是不
只显示除第一行以外的所有其它行
**** 命令3： grep -n
功能：显示文件内容并在每一行前面加上行号，行号数字后面带有分号(:)分隔符。
主要用于对纯数据进行编号，方便查验和比对处理前/处理后的 CSV 电子表文件，
是否存在文件内容操作失误，或者分类错误等异常。
4. LRC歌词文件格式解析
-------------------------
（略）
5. 命令操作示例
-------------------------
6. 已实现的功能
-------------------------
dlist 已实现的功能
** 1001 导出订单信息为 LRC 歌词文件
* 读取文本文件,导出为LRC歌词文件格式
可用于手动编写和修改MP3的LRC歌词文件
将分好线路的订单信息，转换为 MP3 歌曲的 LRC 歌词文件，
这样可以在播放与歌词文件同名的 MP3 歌曲时，可以逐条、定时显示
订单相关信息；
技巧：随便复制或下载一首 MP3 歌曲（最好是播放时间稍微长一点的，
如相声，小品的 MP3），或者是在电脑或手机上用录音机软件录制一段指定
时间长度的声音文件或者空白声音文件，保存为 MP3 格式即可；
更多行业用途:
编写日程计划
学校课程表
公交车报站字幕
旅游景点介绍字幕滚动播出
工厂/人才市场招聘信息滚动播出
商场/商铺/电信营业厅发布促销信息和业务介绍
公交/地铁/电梯等移动传媒发布广告字幕
汽车站/火车站公布车次发车时刻和晚点信息
考试/高考/学校滚动播出考试成绩/录取名单
送礼祝福文字,或者情侣求爱信息
企业/公司/工厂/机构致来宾的欢迎词字幕
彩票网点开奖信息滚动播出
快递员和收件人查看和确认包裹订单信息
(如地址,姓名,电话,应付款,订单号),合理安排
送货路线,降低包裹漏送/漏收,少走重复路
......
* 生成指定时间间隔和步数的空白LRC歌词文件
-------
7. 项目规划和开发进度
-------------------------
* TODO 项目规划和待实现功能
dlist 待实现的功能和事项
* 编写简体中文提示信息
* 编写繁体中文提示信息
* 生成以指定文字开头的连序数字编号并保存到文件,
可以进一步生成可直接打印的条形码
PostScript 文件(*.ps)格式
例: Code128b-100-01 到 Code128b-100-42
* 实现对 CSV 表格文件中关键字的筛选和自动分类排序
* 实现可以生成指定时长的空白MP3文件(即MP3静音文件)
另程序会后续添加 新的“二级字典文件 001.dc2”,
即在 001.dc1 的基础上，再添加新的第二字段，运行时
只有在同一行同时匹配第2列和第3列的内容时，才把原文件的第一列替换为指定字典数据。
================
说明：
这个程序 dlist , 主要是为快递/物流人员，以及快递公司网点设计考虑。
主要目的是按地址片区，把订单自动分类、排序，再输出为可打印的 CSV 表格文件，
直接打印，减少人工筛选地址的工作量，提升物流行业的效率。
还可以把排序后的 CSV文件，导出为 mp3 的歌词文件格式(*.LRC)。
快递员在查看歌词文件时，先把歌曲暂停，这样就可以随意定位歌词的指定行和位置，
（对快递员来说，就是可以随时查看订单相关信息，方便安排自己送货线路，少走重复
路和回头路。还可以减少同一客户提货时多个订单只取走其中某一件的情况。
目前程序部分功能已实现，另有部分功能处于调试状态。等到代码稳定、调试通过后，
稍后会放出程序的 DEB 包，以及使用说明。
8. 字典数据软件包命令规则
-------------------------
** dlist
主程序名
** dlist-dict-jd-zhejiang
dict 代表字典文件；
jd 代表京东网上商城（其他如 tmall 代表天猫...）；
zhejiang 代表浙江省；
** dlist-dict-jd-zhejiang0571
zhejiang后面的 0571 代表杭州市（借用杭州市的电话区号0571）；
** dlist-dict-jd-zhejiang0571-01
0571 后面的 01 代表杭州市的下属网点或分支机构。
** dlist-dict-chinapost-zhejiang310000
对于分支机构和网点较多的中国邮政(China Post)等其他物流/速递企业，
可以借用邮政编码（6位数字）来区别各个分支机构；
** dlist-dict-chinapost-zhejiang310000
9. 如何自己编写和维护字典文件
----------------------------------
10. 常见问题(FAQ)
----------------------------------
* 问 1: dlist 能做什么?
答: dlist 已实现的功能:
** 读取文本文件,导出为LRC歌词文件格式
+ 可用于手动编写和修改MP3的LRC歌词文件
更多行业用途:
+ 编写日程计划
+ 学校课程表
+ 公交车报站字幕
+ 旅游景点介绍字幕滚动播出
+ 工厂/人才市场招聘信息滚动播出
+ 商场/商铺/电信营业厅发布促销信息和业务介绍
+ 公交/地铁/电梯等移动传媒发布广告字幕
+ 汽车站/火车站公布车次发车时刻和晚点信息
+ 考试/高考/学校滚动播出考试成绩/录取名单
+ 送礼祝福文字,或者情侣求爱信息
+ 企业/公司/工厂/机构致来宾的欢迎词字幕
+ 彩票网点开奖信息滚动播出
+ 快递员和收件人查看和确认包裹订单信息
(如地址,姓名,电话,应付款,订单号),合理安排
送货路线,降低包裹漏送/漏收,少走重复路和回头路
......
** 生成指定时间间隔和步数的空白 LRC 歌词文件
目前暂时只支持生成以整数秒（如1/2/3/...）作为时间间隔的
空白 LRC 歌词文件。
* 问 2: 怎么使用 MP3 音乐文件和 LRC 歌词文件?
答: 随便复制或从网上下载一个 MP3 格式的音乐文件(文件名以
.mp3 结尾), 如 001.mp3, 再创建一个 001.lrc 歌词文件。
注意这两个文件前面的文件名必须完全相同。把这两个文件放到电脑，手机或
者平板电脑的同一个文件夹下面，再用音乐视频播放软件，直接打开 001.mp3
音乐文件即可。注意记得打开播放软件的歌词功能。
重要提醒:
建议下载播放时间较长的小品，相声或评书的 MP3 文件，再
手动创建相同文件名的 LRC 歌词文件;
或者是纯乐器演奏的 MP3 文件（即这种 MP3 音乐本来是不可能有
LRC 歌词文件的）。如钢琴，葫芦丝，二胡，萨克斯等乐器演奏的 MP3 音乐。
不推荐使用本身自带歌词的音乐，如流行音乐或热门歌曲。
原因：在电脑/手机/平板电脑上，某些音乐视频播放软件在使用
“自动搜索歌词”功能时，会自动计算文件的 MD5 或者
checksum 校验码，在已经联网的情况下，会根据校验码
在数据库中查找并确认 MP3 音乐的歌曲名称，并可能会自作主张地
下载网上找到的 LRC 歌词文件。如果用户自己手动编写或修改了某
个 LRC 歌词文件，这种情况下歌词内容可能会被自动修改为网上搜
索到的 LRC 歌词文件，用户自己编写的 LRC 歌词文件内容会被完全
修改和损坏。
如果想要播放时只显示歌词或字幕，不想听到音乐，请把音量调到最低
或者静音模式。
也可以用电脑或手机上的录音机软件，录制一段无声音的 MP3 格式文件，
时间长度可以自己决定。
* 问 3: 为什么选择借用 MP3 音乐文件和 LRC 歌词文件格式?
答: 主要看中的是 MP3 音乐文件和 LRC 歌词文件格式的一些优点:
** 在电脑,手机,平板电脑上,很多音乐视频播放软件都支持
MP3 和 LRC 格式；
** 连接到普通电脑显示屏上，就可以显示字幕，不需要额外购买专用或
者特定的显示器。在户外场景中，可以方便地在大尺寸屏幕上显示
滚动字幕；
** LRC 歌词文件其实是一个普通的纯文本文件,可以用文字
处理程序很方便地编写,查看和修改,不需要特殊或专业的编辑软件；
** 在播放 MP3 音乐时, 可以选择循环播放的方式,如是“单曲循环”还是
“全部循环”, 还是“只播放一次”。也就是说，可以用“全部循环”和上一
首/下一首功能来搜索要使用的 MP3 音乐文件和 LRC 歌词，找到后
再设为“单曲循环”，即可实现指定字幕内容的循环滚动播放；
** MP3 支持桌面歌词显示, 还可以方便地暂停或取消歌词和字幕显示；
** 音乐播放软件可以自动搜索保存在电脑或手机上 MP3 音乐文件,
用户可以不用记住 MP3 文件是保存在哪个文件夹里；
* 问 4: 为什么我手机上的QQ音乐, 千千静听等听歌软件无法显示歌词,
提示"找不到本地歌词文件"?
答：1. 首先请确认：在 MP3 文件所在的文件里，有没有一个同名的
.LRC 歌词文件。如果没有，肯定是无法显示歌词的；
2. 某些手机上安卓版本的 QQ 音乐，千千静听等音乐播放软件，
可能会出现无法识别手动编写的 LRC 歌词文件。
可以尝试改用其它的音乐播放软件，如 酷我音乐，酷狗音乐等。
对使用安卓手机/平板的用户，个人推荐使用“酷我音乐”，它在
手动定位歌词等操作上相当方便。
* 问 5: 为什么我自己写的LRC歌词文件,不能显示某个时间以后的所有歌词内
容?
答：很可能是 LRC 歌词文件的时间长度，超过了 MP3 音乐文件的时间长
度。建议换用一首更长时间的 MP3 文件，并对文件名进行相应的
更改（即保证 MP3 音乐文件和 LRC 歌词文件的文件名相同，
只是文件结尾一个是 .mp3, 另一个是 .lrc）。
推荐使用相声，小品，评书等的 MP3 音乐文件，时间长度通常
有10-30分钟, 甚至更长时间。而普通 MP3 音乐的时长一般只有2-3
分钟。
* 问 6: 为什么我的LRC歌词文件第一次播放时能正常显示,但是手机联网后,
再播放时歌词内容变了？
答：这是因为某些音乐视频播放软件的“自动搜索歌词”功能引起的。
电脑/手机/平板电脑上常见的音乐视频播放软件，会自动计算文件的
MD5 或者 checksum 校验码，在已经联网的情况下，会根据校验码
在数据库中查找并确认 MP3 音乐的歌曲名称，并可能会自作主张地
下载网上找到的 LRC 歌词文件。如果用户自己手动编写或修改了某
个 LRC 歌词文件，这种情况下歌词内容可能会被自动修改为网上搜
索到的 LRC 歌词文件，用户自己编写的 LRC 歌词文件内容会被完全
修改和损坏。
如果想要播放时只显示歌词或字幕，不想听到音乐，请把音量调到最低
或者静音模式。
也可以用电脑或手机上的录音机软件，录制一段无声音的 MP3 格式文件，
时间长度可以自己决定。
* 问 7: 我手机上原来有一个 001.mp3 音乐文件和对应的 001.lrc 歌词文件,
后来我复制了 001.mp3 音乐文件为 002.mp3, 并另外写了 002.lrc 歌词
文件, 但是为什么在手机上播放 002.mp3 音乐文件时，还是提示"找不到本
地歌词文件"?
答：很多音乐视频播放软件都会计算 MP3 音乐文件的 MD5 或 checksum 校
验码，来确定歌曲的名称，并保存到数据库。如果两个 MP3 文件的校
验码相同（如上面的 001.mp3 复制为 002.mp3），会认为是同一个
音乐文件，并使用最先找到的成对出现的 LRC 歌词文件。
解决方法：删除原来的 001.mp3 音乐文件，或者把 001.mp3 改
成其它的文件名。
11. 相关链接
----------------------------------
SourceForge: https://sourceforge.net/projects/emacslocale/files/dlist/
12. 版权和授权许可证
----------------------------------
许可证: GPL V3 或者 BSD 许可证
13. 缺陷和风险
-------------------------
重要声明：
本程序目前暂未进行严格的、大数据的测试，请勿在重要场合、
大批量数据环境中使用。本人不承担因使用本程序可能造成的任何直接
或间接损失！
敬请知悉！
Download Latest Version
68-cheLiang-jiaYouJiLuBiao.zip (31.4 kB)
