diff --git a/README.md b/README.md index 98038b2..883b0c2 100644 --- a/README.md +++ b/README.md @@ -52,11 +52,13 @@ Two Chinese version of this list are available [here](https://github.com/alim0x/ *********** - [Setup](#setup) + - [ArchLinux](#arch-linux) + - [Opensuse](#opensuse) - [Ubuntu](#ubuntu) - - [ArchLinux](#arch-linux) -- [Miscellaneous](#miscellaneous) - [Discussion Forums](#discussion-forums) + - [ArchLinux](arch-linux-1) - [Ubuntu](#ubuntu-1) + - [Opensuse](#opensuse-1) - [IRC channels](#irc-channels) - [Linux News, Apps, and more ....](#linux-news-apps-and-more-) - [Reddit](#reddit) @@ -70,6 +72,8 @@ Two Chinese version of this list are available [here](https://github.com/alim0x/ + + ## Applications ### Audio @@ -357,8 +361,9 @@ Two Chinese version of this list are available [here](https://github.com/alim0x/ - [Tcpdump](http://www.tcpdump.org/) - TCP Debugging/Capture Tool![Freeware][Freeware Icon] ### Proxy -- [Shadowsocks](https://shadowsocks.org/en/index.html) - A secure socks5 proxy, -designed to protect your Internet traffic [![Open-Source Software][OSS Icon]](https://github.com/shadowsocks/shadowsocks-qt5/releases) ![Freeware][Freeware Icon] +- [Privoxy](https://www.privoxy.org/) - Privoxy is a non-caching web proxy with advanced filtering capabilities for enhancing privacy, modifying web page data and HTTP headers, controlling access, and removing ads and other obnoxious Internet junk. [![Open-Source Software][OSS Icon]](https://sourceforge.net/projects/ijbswa/) ![Freeware][Freeware Icon] +- [ProxyChains](https://github.com/haad/proxychains) - A tool that forces any TCP connection made by any given application to follow through proxy like TOR or any other SOCKS4, SOCKS5 or HTTP(S) proxy. [![Open-Source Software][OSS Icon]](https://github.com/haad/proxychains) ![Freeware][Freeware Icon] +- [Shadowsocks](https://shadowsocks.org/en/index.html) - A secure socks5 proxy, designed to protect your Internet traffic. [![Open-Source Software][OSS Icon]](https://github.com/shadowsocks/shadowsocks-qt5/releases) ![Freeware][Freeware Icon] ### Sharing Files - [aria2](https://aria2.github.io/) - aria2 is a lightweight multi-protocol & multi-source command-line download utility. [![Open-Source Software][OSS Icon]](https://github.com/aria2/aria2) ![Freeware][Freeware Icon] @@ -511,20 +516,33 @@ designed to protect your Internet traffic [![Open-Source Software][OSS Icon]](ht ## Setup -### Ubuntu - - [What is Linux](https://www.linux.com/what-is-linux) - [Basic Linux term](http://www.makeuseof.com/tag/linux-confusing-key-terms-definitions/) + + +### Arch Linux + +- [Beginners' guide](https://wiki.archlinux.org/index.php/Beginners%27_guide) +- [Installation guide](https://wiki.archlinux.org/index.php/Installation_guide) +- [General recommendations](https://wiki.archlinux.org/index.php/General_recommendations) +- [List of applications](https://wiki.archlinux.org/index.php/List_of_applications) + +### Opensuse + +- [What is Opensuse](https://www.techopedia.com/definition/28543/opensuse) +- [Reason to try Opensuse](http://www.pcworld.com/article/222065/5_reasons_to_try_opensuse_114.html) +- [Beginner's FAQ](https://en.opensuse.org/openSUSE:OpenSUSE_for_beginners) +- [How to install Opensuse](https://en.opensuse.org/Portal:Installation) +- [Review](https://www.linux.com/news/opensuse-leap-421-review-most-mature-linux-distribution) + +### Ubuntu + + - [What is Ubuntu](https://en.wikipedia.org/wiki/Ubuntu_(operating_system)) - [How to install Ubuntu](http://www.ubuntu.com/download/desktop/install-ubuntu-desktop) - [How to dual-boot Ubuntu with Windows](http://www.everydaylinuxuser.com/2014/05/install-ubuntu-1404-alongside-windows.html) - [What to do after installing ubuntu](http://www.omgubuntu.co.uk/2016/04/10-things-to-do-after-installing-ubuntu-16-04-lts) -### Arch Linux -- [Beginners' guide](https://wiki.archlinux.org/index.php/Beginners%27_guide) -- [Installation guide](https://wiki.archlinux.org/index.php/Installation_guide) -- [General recommendations](https://wiki.archlinux.org/index.php/General_recommendations) -- [List of applications](https://wiki.archlinux.org/index.php/List_of_applications) ### Other distros @@ -532,15 +550,21 @@ designed to protect your Internet traffic [![Open-Source Software][OSS Icon]](ht ## Discussion Forums +### Arch Linux + +* [Arch Linux Forums](https://bbs.archlinux.org/) +* [Arch Linux ARM Forums](https://archlinuxarm.org/forum/viewforum.php?f=31) + ### Ubuntu * [Ubuntu Forum](https://ubuntuforums.org/) * [Ask Ubuntu](askubuntu.com/) -### Arch Linux +### Opensuse + +* [Opensuse Forum](https://forums.opensuse.org/forum.php) + -* [Arch Linux Forums](https://bbs.archlinux.org/) -* [Arch Linux ARM Forums](https://archlinuxarm.org/forum/viewforum.php?f=31) ### IRC channels diff --git a/README_zh-CN.md b/README_zh-CN.md index 8ab9d1b..6b87c44 100644 --- a/README_zh-CN.md +++ b/README_zh-CN.md @@ -65,6 +65,7 @@ *********** + ## 应用 ### 音频 @@ -115,8 +116,8 @@ - [Arc Theme](https://github.com/horst3180/arc-theme) - 带有透明元素的扁平化主题 ![Open-Source Software][OSS Icon] ![Freeware][Freeware Icon] - [Compiz Config settings manager](https://apps.ubuntu.com/cat/applications/compizconfig-settings-manager/) - OpenCompositing 项目带来的提高 X Window 系统可用性和生产力的 3D 桌面视觉特效。![Freeware][Freeware Icon] - [Conky](https://github.com/brndnmtthws/conky) - Conky 是 X 下一款免费,轻量的系统监视器,可以在你桌面显示任何类型的信息。 [![Open-Source Software][OSS Icon]](https://github.com/brndnmtthws/conky)![Freeware][Freeware Icon] -- [Flatabulous](https://github.com/anmoljagetia/Flatabulous) - 一款扁平化主题,适用于 Ubuntu 以及其它基于 Gnome 的 Linux 系统。 ![Open-Source Software][OSS Icon] ![Freeware][Freeware Icon] - [Flatabulous Arc Theme](https://github.com/andreisergiu98/arc-flatabulous-theme) - 我最爱的 ubuntu 主题。[![Open-Source Software][OSS Icon]](https://github.com/andreisergiu98/arc-flatabulous-theme)![Freeware][Freeware Icon] +- [Flatabulous](https://github.com/anmoljagetia/Flatabulous) - 一款扁平化主题,适用于 Ubuntu 以及其它基于 Gnome 的 Linux 系统。 ![Open-Source Software][OSS Icon] ![Freeware][Freeware Icon] - [Gnome Extensions](http://extensions.gnome.org/) - Gnome 桌面环境扩展插件。 ![Freeware][Freeware Icon] - [Gnome Look](https://www.gnome-look.org/) - 大量社区创建的图标,shell 主题,字体,以及其他更多的可用来个性化你的 Gnome 桌面环境的资源,都在这一个站点。 [Freeware][Freeware Icon] - [Irradiance Theme](https://github.com/bsundman/Irradiance) - 一款受 OSX Yosemite 启发的 Unity 主题,基于 Radiance。[![Open-Source Software][OSS Icon]](https://github.com/bsundman/Irradiance)![Freeware][Freeware Icon] @@ -443,8 +444,8 @@ - [htop](http://hisham.hm/htop/) - 带有改进的特性和用户体验的 top。[![Open-Source Software][OSS Icon]](https://github.com/hishamhm/htop)![Freeware][Freeware Icon] - [Pacman4console](https://launchpad.net/ubuntu/+source/pacman4console) - 在控制台玩吃豆人。[![Open-Source Software][OSS Icon]](https://github.com/alexdantas/pacman4console.debian)![Freeware][Freeware Icon] - [Tmux](https://tmux.github.io/) - 它让你在一个终端中在多个程序间方便地切换,分离他们(保持在后台运行)并另一个终端中重新连接上去。以及还有好多事情可以做。[![Open-Source Software][OSS Icon]](https://github.com/tmux/tmux)![Freeware][Freeware Icon] -- [十佳命令行工具](http://lifehacker.com/399468/top-10-command-line-tools) - [wicd-curses](https://wiki.archlinux.org/index.php/wicd#Running_Wicd_in_Text_Mode) - 命令行 WiFi 连接管理器。 +- [十佳命令行工具](http://lifehacker.com/399468/top-10-command-line-tools) ## 桌面环境 - [Budgie](https://solus-project.com/budgie/) - Budgie 是一个面向现代用户思想设计的桌面环境,专注于简洁与优雅。[![Open-Source Software][OSS Icon]](https://github.com/solus-project/budgie-desktop) ![Freeware][Freeware Icon] diff --git a/auto_sort/README.md b/auto_sort/README.md index 5cfde98..d5d8dca 100644 --- a/auto_sort/README.md +++ b/auto_sort/README.md @@ -1,5 +1,8 @@ +- [English](#introduction) +- [中文](#介绍) + # Introduction -`asort.py` is a very simple python3 script that aims to make sure items in the README file of the repo [Awesome-Linux-Software](https://github.com/VoLuong/Awesome-Linux-Software) are sorted alphabetically. +`asort.py` is a very simple python3 script that aims to make sure items in the README file of the repo [Awesome-Linux-Software](https://github.com/VoLuong/Awesome-Linux-Software) are sorted alphabetically. This script only sorts items in the following topics for now (items between topic Applications and topic Setup): - Applications @@ -15,5 +18,33 @@ This script only sorts items in the following topics for now (items between topi ![test screenshot](./test.png) +## Note +`asort_zh.py` works for the file [README_zh-CN.md](https://github.com/VoLuong/Awesome-Linux-Software/blob/master/README_zh-CN.md), the Chinese version of this list. + # License MIT License. + +--------------------------------------------- +# 介绍 +`asort.py` 是一个非常简单的 python3 脚本,它负责将 [Awesome-Linux-Software](https://github.com/VoLuong/Awesome-Linux-Software) 仓库的 README.md 文件中的条目按照字母表顺序排列,以方便查阅。 + +该脚本只会为如下几个主题中的条目进行排序(实际上就是在主题 *应用程序* 和 *配置* 之间的所有条目): +- 应用程序 +- 命令行实用工具 +- 桌面环境 +- 显示管理器 +- 窗口管理器 + +# 用法 +1. 请首先按照说明将新的条目添加到合适的主题下,不用考虑排序问题; +1. 然后,确保你在系统上安装了 Python3 运行环境; +1. 打开终端,运行 `python3 asort.py` 即可。之后,你将得到一个新生成的 README 文件,并且文件中所有的在上述几个主题中的条目都已经按照字母表的顺序排列好了。 + +![test 截图](./test.png) + +## 注意 +新增的 `asort_zh.py` 专门用于中文版 [README_zh-CN.md](https://github.com/VoLuong/Awesome-Linux-Software/blob/master/README_zh-CN.md) 条目排序。用法与上面类似。 + +# 许可 +MIT 许可协议。 + diff --git a/auto_sort/asort_zh.py b/auto_sort/asort_zh.py new file mode 100644 index 0000000..ee36679 --- /dev/null +++ b/auto_sort/asort_zh.py @@ -0,0 +1,77 @@ +#!/usr/bin/env python3 +# -*-coding: utf-8-*- +# Author : Christopher L +# Blog : http://blog.chriscabin.com +# GitHub : https://www.github.com/chrisleegit +# File : asort.py +# Date : 2016/08/22 11:12 +# Version: 0.1 +# Description: A very simple python script that can sort items alphabetically. + +import os +import shutil + + +README_FILE = '../README_zh-CN.md' +TEMP_FILE = 'temp_zh.md' + +# only works for those items between BEGIN and END. +BEGIN = '## 应用' +END = '## 设置' + + +def main(): + global README_FILE + + # make sure the script can find file: README.md + README_FILE = os.path.abspath(README_FILE) + + if not os.path.exists(README_FILE): + print('Error: no such file or directory: {}'.format(README_FILE)) + exit(1) + + sort_enable = False + items = list() + + print('Loading file: {}'.format(README_FILE)) + + # read file: README.md + with open(README_FILE) as infile, open(TEMP_FILE, 'w') as outfile: + # process each line + for line in infile: + if not sort_enable and BEGIN in line: + sort_enable = True + + # if sort_enable and END in line: + # sort_enable = False + + if sort_enable: + line = line.strip() + + # each item starts with a character '-' (maybe '*' and '+') + if line.startswith(('-', '*', '+')): + items.append(line) + elif line.startswith('#'): + sort_enable = False if END in line else True + + # when we meet the next header, we should stop adding new item to the list. + for item in sorted(items, key=lambda x: x.upper()): + # write the ordered list to the temporary file. + print(item, file=outfile) + print('', file=outfile) + items.clear() + + # remember to put the next header in the temporary file. + print(line, file=outfile) + else: + print(line, end='', file=outfile) + else: + print(line, end='', file=outfile) + + print('Replace the original file: README_zh-CN.md') + shutil.move(TEMP_FILE, README_FILE) + + +if __name__ == '__main__': + main() +