├── .gitignore
├── package.json
├── vercel.json
├── test
    └── test-function.js
├── api
    ├── about.js
    ├── practice.js
    └── guzhi.js
├── src
    ├── guzhi-card.js
    ├── about-card.js
    ├── practice-card.js
    └── common.js
├── README.md
└── LICENSE


/.gitignore:
--------------------------------------------------------------------------------
1 | package-lock.json
2 | test.svg
3 | node_modules
4 | .vercel


--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "luogu-card",
 3 |     "version": "1.0.0",
 4 |     "description": "",
 5 |     "main": "index.js",
 6 |     "scripts": {},
 7 |     "keywords": [],
 8 |     "author": "cyrxdzj",
 9 |     "license": "LGPL",
10 |     "dependencies": {
11 |         "anafanafo": "^1.0.0",
12 |         "axios": ">=0.24.0"
13 |     }
14 | }
15 | 


--------------------------------------------------------------------------------
/vercel.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "builds": [
 3 |     { "src": "api/*.js", "use": "@vercel/node" },
 4 |     { "src": "test/*.js", "use": "@vercel/node"}
 5 |   ],
 6 |   "routes": [
 7 |     { "src": "/practice", "dest": "/api/practice.js" },
 8 |     { "src": "/guzhi", "dest": "/api/guzhi.js" },
 9 |     { "src": "/about", "dest": "/api/about.js" },
10 |     { "src": "/test-function", "dest": "/test/test-function.js" },
11 |     { "src": "/", "status": 301, "headers": { "Location": "https://cyrxdzj.github.io/2021-07-07-HowToUseLuoguCard/" } }
12 |   ],
13 |   "regions": ["hkg1"]
14 | }
15 | 


--------------------------------------------------------------------------------
/test/test-function.js:
--------------------------------------------------------------------------------
 1 | const {
 2 |   renderNameTitle,
 3 |   renderAboutText,
 4 | } = require("../src/common.js");
 5 | module.exports = async (req, res) => {
 6 |   res.setHeader("Content-Type", "image/svg+xml");
 7 |   if(req.query.function=="rat")
 8 |   {
 9 |     return res.send("<svg>"+renderAboutText(req.query.userType,req.query.followerCount,req.query.followingCount,req.query.ranking,req.query.slogan,req.query.darkmode)+"</svg>");
10 |   }
11 |   else if(req.query.function=="rnt")
12 |   {
13 |     return res.send("<svg>"+renderNameTitle(req.query.name,req.query.color,parseInt(req.query.ccfLevel),req.query.title,parseInt(req.query.cardWidth),req.query.rightTop,req.query.tag)+"</svg>");
14 |   }
15 |   else
16 |   {
17 |     return res.send("<svg>"+renderAboutText("普通用户",3,3,1,"Hello World!",false)+"</svg>");
18 |   }
19 | }
20 | 


--------------------------------------------------------------------------------
/api/about.js:
--------------------------------------------------------------------------------
 1 | const { fetchAbout, renderSVG } = require("../src/about-card.js");
 2 | const { renderError } = require("../src/common.js")
 3 | 
 4 | module.exports = async (req, res) => {
 5 |     const { 
 6 |         id, 
 7 |         hide_title, 
 8 |         dark_mode,
 9 |         disable_cache,
10 |         card_width = 500,
11 |     } = req.query;
12 | 
13 |     res.setHeader("Content-Type", "image/svg+xml");
14 |     if(!disable_cache) {
15 |         res.setHeader("Cache-Control", "public, max-age=43200"); // 43200s（12h） cache
16 |     }
17 | 
18 |     const validId = /^[1-9]\d*$/;
19 |     const clamp = (min, max, n) => Math.max(min, Math.min(max, n));
20 | 
21 |     if(!validId.test(id)) {
22 |         return res.send(renderError(`"${id}"不是一个合法uid`, {darkMode: dark_mode}));
23 |     }
24 |     if(!validId.test(card_width)) {
25 |         return res.send(renderError(`卡片宽度"${card_width}"不合法`, {darkMode: dark_mode}));
26 |     }
27 |     
28 |     const about = await fetchAbout(id);
29 |     return res.send(renderSVG(about, {
30 |         hideTitle: hide_title,
31 |         darkMode: dark_mode,
32 |         cardWidth: clamp(500, 1920, card_width),
33 |     }));
34 | };
35 | 


--------------------------------------------------------------------------------
/api/practice.js:
--------------------------------------------------------------------------------
 1 | const { fetchStats, renderSVG } = require("../src/practice-card.js");
 2 | const { renderError } = require("../src/common.js")
 3 | 
 4 | module.exports = async (req, res) => {
 5 |     const { 
 6 |         id, 
 7 |         hide_title, 
 8 |         dark_mode,
 9 |         disable_cache,
10 |         card_width = 500,
11 |     } = req.query;
12 | 
13 |     res.setHeader("Content-Type", "image/svg+xml");
14 |     if(!disable_cache){
15 |         res.setHeader("Cache-Control", "public, max-age=43200"); // 43200s（12h） cache
16 |     }
17 | 
18 |     const validId = /^[1-9]\d*$/;
19 |     const clamp = (min, max, n) => Math.max(min, Math.min(max, n));
20 | 
21 |     if(!validId.test(id)) {
22 |         return res.send(renderError(`"${id}"不是一个合法uid`, {darkMode: dark_mode}));
23 |     }
24 |     if(!validId.test(card_width)) {
25 |         return res.send(renderError(`卡片宽度"${card_width}"不合法`, {darkMode: dark_mode}));
26 |     }
27 | 
28 |     const stats = await fetchStats(id);
29 |     return res.send(renderSVG(stats, {
30 |         hideTitle: hide_title,
31 |         darkMode: dark_mode,
32 |         cardWidth: clamp(500, 1920, card_width),
33 |     }));
34 | };
35 | 


--------------------------------------------------------------------------------
/src/guzhi-card.js:
--------------------------------------------------------------------------------
 1 | const {
 2 |     Card,
 3 |     renderError,
 4 |     renderChart,
 5 |     renderNameTitle,
 6 | } = require("./common.js");
 7 | 
 8 | const renderGuzhiCard = (userInfo, scores, options) => {
 9 |     const regNum = /^\d*$/;
10 |     if(!scores || typeof scores !== 'string') {
11 |         return renderError('咕值信息不能为空', options={width:360});
12 |     }
13 |     let sp = ',';
14 |     if(scores.indexOf('，') >= 0) {
15 |         sp = '，';
16 |     }
17 |     const scoreArray = scores.split(sp).filter(x => regNum.test(x)).map(x => parseInt(x)).filter(x => x >= 0 && x <= 100);
18 |     if(scoreArray.length != 5) {
19 |         return renderError(`咕值信息"${scores}"不合法`, options={width:360});
20 |     }
21 |     const scoreSum = scoreArray.reduce((a, b) => a+b);
22 | 
23 |     const {
24 |         name,
25 |         color,
26 |         ccfLevel,
27 |         tag
28 |     } = userInfo || {};
29 | 
30 |     const { 
31 |         hideTitle, 
32 |         darkMode,
33 |         cardWidth = 500, 
34 |     } = options || {};
35 | 
36 |     const paddingX = 25;
37 |     const labelWidth = 90;    //柱状图头部文字长度
38 |     const progressWidth = cardWidth - 2*paddingX - labelWidth - 60; //500 - 25*2(padding) - 90(头部文字长度) - 60(预留尾部文字长度)，暂时固定，后序提供自定义选项;
39 | 
40 |     const getScoreColor = (score) => {
41 |         if (score >= 80) return "#52c41a";
42 |         if (score >= 60) return "#fadb14";
43 |         if (score >= 30) return "#f39c11";
44 |         return "#e74c3c";
45 |     }
46 |     const datas = [
47 |         {label: "基础信用", data: scoreArray[0], color: getScoreColor(scoreArray[0])},
48 |         {label: "练习情况", data: scoreArray[1], color: getScoreColor(scoreArray[1])},
49 |         {label: "社区贡献", data: scoreArray[2], color: getScoreColor(scoreArray[2])},
50 |         {label: "比赛情况", data: scoreArray[3], color: getScoreColor(scoreArray[3])},
51 |         {label: "获得成就", data: scoreArray[4], color: getScoreColor(scoreArray[4])},
52 |     ]
53 | 
54 |     const title = userInfo != null ? renderNameTitle(name, color, ccfLevel, "的咕值信息", cardWidth, `总咕值: ${scoreSum}分`, tag) : "";
55 | 
56 |     const body = renderChart(datas, labelWidth, progressWidth, "分");
57 | 
58 |     return new Card({
59 |         width: cardWidth - 2*paddingX,
60 |         height: datas.length*30 + 10,
61 |         hideTitle,
62 |         darkMode,
63 |         title,
64 |         body,
65 |     }).render();
66 | }
67 | 
68 | module.exports = { renderGuzhiCard }
69 | 


--------------------------------------------------------------------------------
/src/about-card.js:
--------------------------------------------------------------------------------
 1 | const axios = require("axios");
 2 | const {
 3 |     Card,
 4 |     renderError,
 5 |     renderChart,
 6 |     renderNameTitle,
 7 |     renderAboutText,
 8 | } = require("./common.js");
 9 | 
10 | /**
11 |  * 
12 |  * @param {number} id 用户id
13 |  * @returns {Object} 获取的用户数据 {name, color, ccfLevel, slogan, followerCount, followingCount}
14 |  */
15 | async function fetchAbout(id) {
16 |     //debug 测试请求
17 |     //const res = await axios.get(`https://tc-0glpuj1k4e75e5ec-1300876583.ap-shanghai.service.tcloudbase.com/luogu?id=${id}`);
18 | 
19 |     const res = await axios.get(`https://www.luogu.com.cn/user/${id}?_contentOnly`)
20 | 
21 |     const about = {
22 |         name: "NULL",
23 |         color: "Gray",
24 |         ccfLevel: 0,
25 |         slogan: "",
26 |         followerCount: 0,
27 |         followingCount:0,
28 |         ranking:-1,
29 |         userType:"Not found.",
30 |         tag:""
31 |     }
32 |     if(res.data.code !== 200) {
33 |         return about;
34 |     }
35 |     const user = res.data.currentData.user;
36 |     
37 |     about.name = decodeURI(user.name);
38 |     about.color = decodeURI(user.color);
39 |     about.ccfLevel = user.ccfLevel;
40 |     about.slogan = decodeURI(user.slogan);
41 |     about.followerCount = user.followerCount;
42 |     about.followingCount = user.followingCount;
43 |     about.ranking = user.ranking;
44 |     about.userType = user.isAdmin?"管理员":(user.isBanned?"封禁用户":"普通用户");
45 |     about.tag = decodeURI(user.badge);
46 |     
47 |     return about;
48 | }
49 | 
50 | const renderSVG = (about, options) => {
51 |     const {
52 |         name,
53 |         color,
54 |         ccfLevel,
55 |         slogan,
56 |         followerCount,
57 |         followingCount,
58 |         ranking,
59 |         userType,
60 |         tag
61 |     } = about;
62 |     
63 |     const { 
64 |         hideTitle, 
65 |         darkMode,
66 |         cardWidth = 500, 
67 |     } = options || {};
68 |     
69 |     const paddingX = 25;
70 |     const body = renderAboutText(userType,followerCount,followingCount,ranking,slogan,darkMode);
71 |     const title = renderNameTitle(name, color, ccfLevel, "的基本信息", cardWidth, "",tag);
72 |     
73 |     return new Card({
74 |         width: cardWidth - 2*paddingX,
75 |         height: 4 * 30 + 10,
76 |         hideTitle,
77 |         darkMode,
78 |         title,
79 |         body,
80 |     }).render();
81 | }
82 | 
83 | module.exports = { fetchAbout, renderSVG }
84 | 


--------------------------------------------------------------------------------
/api/guzhi.js:
--------------------------------------------------------------------------------
 1 | const { renderGuzhiCard } = require("../src/guzhi-card.js");
 2 | const { fetchAbout } = require("../src/about-card.js");
 3 | const { renderError } = require("../src/common.js")
 4 | const axios = require("axios");
 5 | 
 6 | async function fetchGuzhi(id, ranking) {
 7 |     var page=Math.floor((ranking-1)/50) + 1;
 8 |     
 9 |     const res = await axios.get(`https://www.luogu.com.cn/ranking?page=${page}&_contentOnly`);
10 |     
11 |     if(res.data.code != 200) {
12 |         return "Not found.";
13 |     }
14 |     
15 |     const rankList=res.data.currentData.rankList.result;
16 |     
17 |     for(var index=0;index<50;index++) {
18 |         if(!rankList[index]) {
19 |             continue;
20 |         }
21 |         if(rankList[index].user.uid==id) {
22 |             return `${rankList[index].basicRating},${rankList[index].practiceRating},${rankList[index].socialRating},${rankList[index].contestRating},${rankList[index].prizeRating}`;
23 |         }
24 |     }
25 |     return `Not found.`;
26 | }
27 | 
28 | module.exports = async (req, res) => {
29 |     const { id, scores, hide_title, dark_mode, disable_cache, card_width = 500 } = req.query;
30 |     var finally_scores
31 | 
32 |     res.setHeader("Content-Type", "image/svg+xml");
33 |     if(!disable_cache){
34 |         res.setHeader("Cache-Control", "public, max-age=43200"); // 43200s（12h） cache
35 |     }
36 | 
37 |     const regNum = /^[1-9]\d*$/;
38 |     const clamp = (min, max, n) => Math.max(min, Math.min(max, n));
39 | 
40 |     if (!regNum.test(card_width)) {
41 |         return res.send(
42 |             renderError(`卡片宽度"${card_width}"不合法`, { darkMode: dark_mode })
43 |         );
44 |     }
45 |     if(id != undefined && !regNum.test(id)) {
46 |         return res.send(renderError(`"${id}"不是一个合法uid`, {darkMode: dark_mode}));
47 |     }
48 | 
49 |     let about = null;
50 | 
51 |     if(id != undefined) {
52 |         about = await fetchAbout(id);
53 |     }
54 |     
55 |     if(about.ranking>=1&&about.ranking<=1000)
56 |     {
57 |         finally_scores=await fetchGuzhi(id, about.ranking);
58 |         if(finally_scores=="Not found.")
59 |         {
60 |             finally_scores=scores;
61 |         }
62 |     }
63 |     else
64 |     {
65 |         finally_scores=scores;
66 |     }
67 | 
68 |     return res.send(
69 |         renderGuzhiCard(about, finally_scores, {
70 |             hideTitle: about === null ? true : hide_title,
71 |             darkMode: dark_mode,
72 |             cardWidth: clamp(500, 1920, card_width),
73 |         })
74 |     );
75 | };
76 | 


--------------------------------------------------------------------------------
/src/practice-card.js:
--------------------------------------------------------------------------------
  1 | const axios = require("axios");
  2 | const {
  3 |     Card,
  4 |     renderError,
  5 |     renderChart,
  6 |     renderNameTitle,
  7 | } = require("./common.js");
  8 | 
  9 | /**
 10 |  * 
 11 |  * @param {number} id 用户id
 12 |  * @returns {Object} 获取的用户数据 {name, color, ccfLevel, passed, hideInfo}
 13 |  */
 14 | async function fetchStats(id) {
 15 |     //debug 测试请求
 16 |     //const res = await axios.get(`https://tc-0glpuj1k4e75e5ec-1300876583.ap-shanghai.service.tcloudbase.com/luogu?id=${id}`);
 17 | 
 18 |     const res = await axios.get(`https://www.luogu.com.cn/user/${id}?_contentOnly`)
 19 | 
 20 |     const stats = {
 21 |         name: "NULL",
 22 |         color: "Gray",
 23 |         ccfLevel: 0,
 24 |         passed: [0,0,0,0,0,0,0,0],
 25 |         unpassed: 0,
 26 |         hideInfo: false
 27 |     }
 28 |     if(res.data.code !== 200) {
 29 |         return stats;
 30 |     }
 31 | 
 32 |     const user = res.data.currentData.user;
 33 |     const passed = res.data.currentData.passedProblems;
 34 | 
 35 |     if(!passed) {
 36 |         stats.hideInfo = true;
 37 |         return stats;
 38 |     }
 39 | 
 40 |     stats.name = decodeURI(user.name);
 41 |     stats.color = user.color;
 42 |     stats.ccfLevel = user.ccfLevel;
 43 |     stats.tag = decodeURI(user.badge);
 44 |     stats.unpassed = res.data.currentData.submittedProblems.length;
 45 | 
 46 |     for(let i of passed) {
 47 |         stats.passed[i.difficulty]++;
 48 |     }
 49 | 
 50 |     return stats;
 51 | } 
 52 | 
 53 | const renderSVG = (stats, options) => {
 54 |     const {
 55 |         name,
 56 |         color,
 57 |         ccfLevel,
 58 |         passed,
 59 |         unpassed,
 60 |         hideInfo,
 61 |         tag
 62 |     } = stats;
 63 | 
 64 |     const { 
 65 |         hideTitle, 
 66 |         darkMode,
 67 |         cardWidth = 500, 
 68 |     } = options || {};
 69 | 
 70 |     if(hideInfo) {
 71 |         return renderError("用户开启了“完全隐私保护”，获取数据失败", options={width:360});
 72 |     }
 73 |     
 74 |     const paddingX = 25;
 75 |     const labelWidth = 90;    //柱状图头部文字长度
 76 |     const progressWidth = cardWidth - 2*paddingX - labelWidth - 60; //500 - 25*2(padding) - 90(头部文字长度) - 60(预留尾部文字长度)，暂时固定，后序提供自定义选项;
 77 | 
 78 |     const datas = [
 79 |         {label: "未评定", color:"#bfbfbf", data: passed[0]},
 80 |         {label: "入门", color:"#fe4c61", data: passed[1]},
 81 |         {label: "普及-", color:"#f39c11", data: passed[2]},
 82 |         {label: "普及/提高-", color:"#ffc116", data: passed[3]},
 83 |         {label: "普及+/提高", color:"#52c41a", data: passed[4]},
 84 |         {label: "提高+/省选-", color:"#3498db", data: passed[5]},
 85 |         {label: "省选/NOI-", color:"#9d3dcf", data: passed[6]},
 86 |         {label: "NOI/NOI+/CTSC", color:"#0e1d69", data: passed[7]},
 87 |         {label: "心有余而力不足", color:"#0101DF", data: unpassed}
 88 |     ]
 89 |     const passedSum = passed.reduce((a, b) => a + b);
 90 |     const body = renderChart(datas, labelWidth, progressWidth, "题");
 91 | 
 92 |     const title = renderNameTitle(name, color, ccfLevel, "的练习情况", cardWidth, `已通过: ${passedSum}题`,tag);
 93 | 
 94 |     return new Card({
 95 |         width: cardWidth - 2*paddingX,
 96 |         height: datas.length*30 + 10,
 97 |         hideTitle,
 98 |         darkMode,
 99 |         title,
100 |         body,
101 |     }).render();
102 | }
103 | 
104 | module.exports = { fetchStats, renderSVG }
105 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | ~~很快，该项目就会被迁移至Netlify，代码将会基本重写。此分支将会被废弃。~~
  2 | 
  3 | ~~现实告诉我Netlify还是不能用。~~
  4 | 
  5 | 不过也许可以试试华为云函数？
  6 | 
  7 | 我又想起了，可以用next.js部署在Netlify上。
  8 | 
  9 | > 该项目是由[wao3/luogu-stats-card](https://github.com/wao3/luogu-stats-card)复制过来并加以二次开发的的，感谢TA的贡献。
 10 | 
 11 | > 注意：为了不滥用洛谷服务器流量，本项目利用 vercel 的边缘缓存功能缓存了 12 小时数据，即同一个用户卡片 **24 小时内最多只会向洛谷服务器请求 2 次数据**，并且只有在用户访问卡片时才会请求数据。不过，可以禁用缓存。
 12 | ## 简介
 13 | 
 14 | ![stars](https://badgen.net/github/stars/cyrxdzj/luogu-card?cache=600)
 15 | ![forks](https://badgen.net/github/forks/cyrxdzj/luogu-card?cache=600)
 16 | ![visitor](https://visitor-badge.laobi.icu/badge?page_id=luogu-card)
 17 | ![last commit](https://badgen.net/github/last-commit/cyrxdzj/luogu-card?cache=600)
 18 | ![top language](https://img.shields.io/github/languages/top/cyrxdzj/luogu-card)
 19 | 
 20 | `luogu-card`是一个动态生成洛谷用户数据卡片的工具，可以展示自己的做题情况。可以用于个人主页、博客、github等可以插入图片的地方。
 21 | 
 22 | ## TODO
 23 | 
 24 | - [x] ~~修复获取数据错误和用户设置数据不可见的bug~~
 25 | - [x] ~~增加黑暗模式~~
 26 | - [x] ~~增加咕值卡片~~
 27 | 
 28 | 以上内容由原作者完成，以下内容由我完成。
 29 | 
 30 | - [x] ~~增加About卡片~~
 31 | - [x] ~~增加用户 tag~~
 32 | - [x] ~~增加“卡片生成时间”标签~~
 33 | - [x] ~~自动从咕值排名中获取咕值~~
 34 | - [x] ~~禁用缓存~~
 35 | - [x] ~~在练习情况里增加“写挂了”（实际执行情况是“心有余而力不足”）~~
 36 | 
 37 | ## 如何使用
 38 | 
 39 | ### 基本信息
 40 | 
 41 | ![dengzijun的基本信息](https://luogu-card.vercel.app/about?id=387836)
 42 | 
 43 | 此卡片用于显示一个用户的基本信息，包括用户类型、关注、咕值排名、个性签名。
 44 | 
 45 | 具体使用方法如下：
 46 | 
 47 | 1. 仅使用图片：直接复制以下内容到任意 markdown 编辑器中，并将`?id=`后面的数字更改为自己的 id 即可（id是洛谷的用户编号）。
 48 | 
 49 |    ```markdown
 50 |    ![dengzijun的基本信息](https://luogu-card.vercel.app/about?id=387836)
 51 |    ```
 52 | 
 53 | 2. 使用图片链接：复制以下内容，第二个小括号内的地址是点击该图片跳转的地址，建议设置为洛谷个人主页。
 54 | 
 55 |    ```markdown
 56 |    [![dengzijun的基本信息](https://luogu-card.vercel.app/about?id=387836)](https://github.com/cyrxdzj/luogu-card)
 57 |    ```
 58 | 
 59 | ### 练习情况
 60 | 
 61 | ![dengzijun的练习情况](https://luogu-card.vercel.app/practice?id=387836)
 62 | 
 63 | 练习情况可以自动获取用户的数据，但是前提是没有开启“完全隐私保护”。
 64 | 
 65 | 具体使用方法如下：
 66 | 
 67 | 1. 仅使用图片：直接复制以下内容到任意 markdown 编辑器中，并将`?id=`后面的数字更改为自己的 id 即可（id是洛谷的用户编号）。
 68 | 
 69 |    ```markdown
 70 |    ![dengzijun的练习情况](https://luogu-card.vercel.app/practice?id=387836)
 71 |    ```
 72 | 
 73 | 2. 使用图片链接：复制以下内容，第二个小括号内的地址是点击该图片跳转的地址，建议设置为洛谷个人主页。
 74 | 
 75 |    ```markdown
 76 |    [![dengzijun的练习情况](https://luogu-card.vercel.app/practice?id=387836)](https://github.com/cyrxdzj/luogu-card)
 77 |    ```
 78 | 
 79 | ### 咕值信息
 80 | 
 81 | ![dengzijun的咕值信息](https://luogu-card.vercel.app/guzhi?id=387836)
 82 | 
 83 | 咕值信息一般无法自动获取数据，如果需要必须要提供cookie，但是这种方法十分不安全，并且不方便。所以获取咕值卡片可能需要手动输入咕值信息，具体使用方法如下：
 84 | 
 85 | 复制以下内容到任意 markdown 编辑器中，并将 `?id=`后面的数字更改为自己的 id，将`scores=`后面更换为自己的咕值信息，一共 5 个数字，用逗号分隔。
 86 | 
 87 | 1. 仅使用图片：复制以下内容到任意 markdown 编辑器中，并将 `?id=`后面的数字更改为自己的 id，将`scores=`后面更换为自己的咕值信息，一共 5 个数字（分别代表基础信用、练习情况、社区贡献、比赛情况、获得成就），用英文半角逗号分隔。
 88 | 
 89 |    ```markdown
 90 |    ![dengzijun的咕值信息](http://luogu-card.vercel.app/guzhi?id=387836&scores=100,70,25,45,0)
 91 |    ```
 92 |    
 93 | 2. 使用图片链接：复制以下内容，第二个小括号内的地址是点击该图片跳转的地址，建议设置为洛谷个人主页。
 94 |    ```markdown
 95 |    [![dengzijun的咕值信息](http://luogu-card.vercel.app/guzhi?id=387836&scores=100,70,25,45,0)](https://github.com/cyrxdzj/luogu-card)
 96 |    ```
 97 |    
 98 | 
 99 | 注意，若程序检测到咕值排名在1000名以内，则程序会自动从“咕值排名”中获取咕值。若获取成功，程序将无视用户输入。不过此功能偶尔会出BUG，所以最好还是手动设置一下咕值吧。
100 | 
101 | 
102 | ### 自定义选项
103 | 
104 | 使用卡片时，支持设定自定义效果选项，可以组合使用。
105 | 
106 | 1. **隐藏标题**，只需在链接最后带上`&hide_title=true`即可，例如：
107 | 
108 |    ```markdown
109 |    ![dengzijun的练习情况](https://luogu-card.vercel.app/practice?id=387836&hide_title=true)
110 |    ```
111 | 
112 |    效果：
113 | 
114 |    ![dengzijun的练习情况](https://luogu-card.vercel.app/practice?id=387836&hide_title=1)
115 | 
116 | 2. **黑暗模式**，只需在链接最后带上`&dark_mode=true`即可，例如：
117 | 
118 |    ```markdown
119 |    ![dengzijun的练习情况](https://luogu-card.vercel.app/practice?id=387836&dark_mode=true)
120 |    ```
121 | 
122 |    效果：
123 | 
124 |    ![dengzijun的练习情况](https://luogu-card.vercel.app/practice?id=387836&dark_mode=true)
125 | 3. **自定义宽度**，默认500，限制宽度在500到1920之间，只需在链接最后带上`&card_width=需要的宽度`即可，例如：
126 | 
127 |    ```markdown
128 |    ![dengzijun的练习情况](https://luogu-card.vercel.app/practice?id=387836&card_width=750)
129 |    ```
130 | 
131 |    效果：
132 | 
133 |    ![dengzijun的练习情况](https://luogu-card.vercel.app/practice?id=387836&card_width=750)
134 |    
135 | 4. **禁用缓存**，默认情况下，程序会有12小时的缓存。但是只需在链接最后带上`&disable_cache=true`即可禁用缓存，每次访问都将刷新。
136 | 
137 | ## 自行部署
138 | 
139 | 如果想要自行试验或者二次开发可以自行部署到自己的 vercel 服务器，登录 [vercel](https://vercel.com/) 后，点击下方按钮即可部署。
140 | 
141 | [![Deploy to Vercel](https://vercel.com/button)](https://vercel.com/import/project?template=https://github.com/cyrxdzj/luogu-card)
142 | 
143 | ## 如何参与贡献
144 | 
145 | #### 提供bug反馈或建议
146 | 
147 | 使用 [issue](https://github.com/cyrxdzj/luogu-card/issues) 反馈bug时，尽可能详细描述 bug 及其复现步骤
148 | 
149 | #### 贡献代码的步骤
150 | 
151 | 1. fork项目到自己的repo
152 | 2. 把fork过去的项目也就是你的项目clone到你的本地
153 | 3. 修改代码
154 | 4. commit后push到自己的库
155 | 5. 在Github首页可以看到一个 pull request 按钮，点击它，填写一些说明信息，然后提交即可。
156 | 6. 等待作者合并
157 | 
158 | ## 其他
159 | 
160 | 如果对你有所帮助的话，希望能在右上角点一个 star (★ ω ★)
161 | 
162 | ## LICENSE
163 | 
164 | [![GNU Lesser General Public License v2.1](https://badgen.net/github/license/cyrxdzj/luogu-card)](https://github.com/cyrxdzj/luogu-card/blob/master/LICENSE)
165 | 
166 | ## 镜像仓库
167 | 
168 | ~~要不是vercel不支持Gitee只支持Github，我也不会出现在这里了~~
169 | 
170 | 本仓库在码云Gitee上创建了一个[镜像仓库](https://gitee.com/cyrxdzj/luogu-card)，但会有同步延迟。也可以访问位于Github的[源仓库](https://github.com/cyrxdzj/luogu-card)。
171 | 
172 | [![star](https://gitee.com/cyrxdzj/luogu-card/badge/star.svg?theme=dark)](https://gitee.com/cyrxdzj/luogu-card/stargazers)
173 | 
174 | [![cyrxdzj/luogu-card](https://gitee.com/cyrxdzj/luogu-card/widgets/widget_card.svg?colors=eae9d7,2e2f29,272822,484a45,eae9d7,747571)](https://gitee.com/cyrxdzj/luogu-card)
175 | 


--------------------------------------------------------------------------------
/src/common.js:
--------------------------------------------------------------------------------
  1 | const anafanafo = require('anafanafo');
  2 | 
  3 | const NAMECOLOR = {
  4 |     "Gray": "#bbbbbb",
  5 |     "Blue": "#0e90d2",
  6 |     "Green": "#5eb95e",
  7 |     "Orange": "#e67e22",
  8 |     "Red": "#e74c3c",
  9 |     "Purple": "#9d3dcf",
 10 |     "Cheater": "#ad8b00"
 11 | }
 12 | 
 13 | class Card {
 14 |     constructor({
 15 |         width = 450,
 16 |         height = 250,
 17 |         title = "",
 18 |         body = "",
 19 |         titleHeight = 25,
 20 |         hideTitle = false,
 21 |         css = "",
 22 |         darkMode = "",
 23 |         paddingX = 25,
 24 |         paddingY = 35,
 25 |         hideBorder = false,
 26 |     }) {
 27 |         this.width = width;
 28 |         this.height = height;
 29 |         this.titleHeight = titleHeight;
 30 |         this.title = title;
 31 |         this.body = body;
 32 |         this.hideTitle = hideTitle;
 33 |         this.css = css;
 34 |         this.darkMode = darkMode;
 35 |         this.paddingX = paddingX;
 36 |         this.paddingY = paddingY;
 37 |         this.hideBorder = hideBorder;
 38 |     }
 39 | 
 40 |     render() {
 41 |         var d = new Date();
 42 |         var beijingTime = new Date(d.getTime() + (parseInt(d.getTimezoneOffset()/60) + 8) * 3600 * 1000);
 43 |         var timeStr = `${beijingTime.getFullYear()}-${(beijingTime.getMonth()+1)<10?"0":""}${beijingTime.getMonth()+1}-${beijingTime.getDate()<10?"0":""}${beijingTime.getDate()} ${beijingTime.getHours()<10?"0":""}${beijingTime.getHours()}:${beijingTime.getMinutes()<10?"0":""}${beijingTime.getMinutes()}:${beijingTime.getSeconds()<10?"0":""}${beijingTime.getSeconds()}`
 44 |         
 45 |         const cardSize = {
 46 |             width: this.width + 2*this.paddingX,
 47 |             height: this.height + 2*this.paddingY,
 48 |         };
 49 |         if(!this.hideTitle) cardSize.height += this.titleHeight;
 50 | 
 51 |         const bgColor = this.darkMode?"#444444":"#fffefe";
 52 |         let borderColor = "";
 53 |         if(!this.hideBorder) borderColor = this.darkMode?"#444444":"#E4E2E2";
 54 | 
 55 |         return `
 56 |             <svg xmlns="http://www.w3.org/2000/svg" width="${cardSize.width}" height="${cardSize.height}" viewBox="0 0 ${cardSize.width} ${cardSize.height}" fill="none">
 57 |                 <style>
 58 |                     .text { font: 400 11px 'Segoe UI', Ubuntu, Sans-Serif; fill: ${this.darkMode?"#fffefe":"#333333"} }
 59 |                     .about-text { font: 400 11px 'Segoe UI', Ubuntu, Sans-Serif; fill: ${this.darkMode?"#fffefe":"#333333"} }
 60 |                     .about-text-grey { font: 400 11px 'Segoe UI', Ubuntu, Sans-Serif; fill: #848484 }
 61 |                     .title {fill: ${this.darkMode?"#fffefe":"#333333"}}
 62 |                     .line { stroke:${this.darkMode?"#666666":"#dddddd"}; stroke-width:1 }
 63 |                     ${this.css}
 64 |                 </style>
 65 |                 <rect x="0.5" y="0.5" rx="4.5" height="99%" stroke="${borderColor}" width="99%" fill="${bgColor}" stroke-opacity="1" />
 66 |                 
 67 |                 ${this.hideTitle ? `` : `
 68 |                 <g transform="translate(${this.paddingX}, ${this.paddingY})">
 69 |                     ${this.title}
 70 |                 </g>`}
 71 | 
 72 |                 <g transform="translate(${this.paddingX}, ${this.hideTitle ? this.paddingY : this.paddingY + this.titleHeight})">
 73 |                     ${this.body}
 74 |                 </g>
 75 |                 <g transform="translate(${this.paddingX}, ${cardSize.height - this.paddingY})"><text x="0" y="15" class="about-text-grey">卡片生成时间：${timeStr}</text></g>
 76 |             </svg>`;
 77 |     }
 78 | }
 79 | 
 80 | /**
 81 |  * 渲染错误卡片
 82 |  * @param {string} e 描述错误的文本
 83 |  * @param {Object} option 其余选项
 84 |  */
 85 | const renderError = (e, option) => {
 86 |     const css = `.t {font: 600 18px 'Microsoft Yahei UI'; fill: #e74c3c;}`
 87 |     const text = `<text class="t" dominant-baseline="text-before-edge">${e}</text>`
 88 |     return new Card({
 89 |         width: 300,
 90 |         height: 23,
 91 |         hideTitle: true,
 92 |         css,
 93 |         body: text,
 94 |         paddingY: 20,
 95 |         paddingX: 20,
 96 |         ...option,
 97 |     }).render();
 98 | };
 99 | 
100 | /**
101 |  * 渲染 ccf badge
102 |  * @param {number} level CCF等级
103 |  * @param {number} x badge的x坐标
104 |  * @returns {string} ccf badge的svg字符串
105 |  */
106 | const renderCCFBadge = (level, x) => {
107 |     const ccfColor = (ccf) => {
108 |         if(ccf >= 3 && ccf <= 5) return "#5eb95e";
109 |         if(ccf >= 6 && ccf <= 7) return "#3498db";
110 |         if(ccf >= 8) return "#f1c40f";
111 |         return null;
112 |     }
113 |     return `
114 |     <svg xmlns="http://www.w3.org/2000/svg" x="${x}" y="-14" width="18" height="18" viewBox="0 0 18 18" fill="${ccfColor(level)}" style="margin-bottom: -3px;">
115 |         <path d="M16 8C16 6.84375 15.25 5.84375 14.1875 5.4375C14.6562 4.4375 14.4688 3.1875 13.6562 2.34375C12.8125 1.53125 11.5625 1.34375 10.5625 1.8125C10.1562 0.75 9.15625 0 8 0C6.8125 0 5.8125 0.75 5.40625 1.8125C4.40625 1.34375 3.15625 1.53125 2.34375 2.34375C1.5 3.1875 1.3125 4.4375 1.78125 5.4375C0.71875 5.84375 0 6.84375 0 8C0 9.1875 0.71875 10.1875 1.78125 10.5938C1.3125 11.5938 1.5 12.8438 2.34375 13.6562C3.15625 14.5 4.40625 14.6875 5.40625 14.2188C5.8125 15.2812 6.8125 16 8 16C9.15625 16 10.1562 15.2812 10.5625 14.2188C11.5938 14.6875 12.8125 14.5 13.6562 13.6562C14.4688 12.8438 14.6562 11.5938 14.1875 10.5938C15.25 10.1875 16 9.1875 16 8ZM11.4688 6.625L7.375 10.6875C7.21875 10.8438 7 10.8125 6.875 10.6875L4.5 8.3125C4.375 8.1875 4.375 7.96875 4.5 7.8125L5.3125 7C5.46875 6.875 5.6875 6.875 5.8125 7.03125L7.125 8.34375L10.1562 5.34375C10.3125 5.1875 10.5312 5.1875 10.6562 5.34375L11.4688 6.15625C11.5938 6.28125 11.5938 6.5 11.4688 6.625Z">
116 |         </path>
117 |     </svg>`
118 | }
119 | 
120 | /**
121 |  * 渲染柱状图
122 |  * @param {Object[]} datas 柱状图的数据数组
123 |  * @param {string} datas.label 一条数据的标签
124 |  * @param {string} datas.color 一条数据的颜色
125 |  * @param {number} datas.data 一条数据的数值
126 |  * @param {number} labelWidth 标签宽度
127 |  * @param {number} progressWidth 柱状图的长度
128 |  * @param {string} [unit] 数据单位
129 |  */
130 | const renderChart = (datas, labelWidth, progressWidth, unit) => { //(label, color, height, num, unit) => {
131 |     let chart = "";
132 |     let maxNum = datas.reduce((a, b) => Math.max(a, b.data), 0);
133 |     maxNum = (parseInt((maxNum-1) / 100) + 1) * 100;
134 | 
135 |     for(let i = 0; i < datas.length; ++i) {
136 |         const width = (datas[i].data+1) / (maxNum+1) * progressWidth;
137 |         chart += `
138 |         <g transform="translate(0, ${i*30})">
139 |             <text x="0" y="15" class="text">${datas[i].label}</text>
140 |             <text x="${width + labelWidth + 10}" y="15" class="text">${datas[i].data + unit}</text>
141 |             <rect height="11" fill="${datas[i].color}" rx="5" ry="5" x="${labelWidth}" y="5" width="${width}"></rect>
142 |         </g>
143 |         `
144 |     }
145 | 
146 |     const bodyHeight = datas.length * 30 + 10;
147 |     const dw = progressWidth / 4;
148 |     let coordinate = "";
149 |     for(let i = 0; i <= 4; ++i) {
150 |         coordinate += `
151 |         <line x1="${labelWidth + dw*i}" y1="0" x2="${labelWidth + dw*i}" y2="${bodyHeight - 10}"    class="line"/>
152 |         <text x="${labelWidth + dw*i - (i==0?3:5) }" y="${bodyHeight}"    class="text">${maxNum*i/4}</text>
153 |         `;
154 |     }
155 |     return coordinate + chart;
156 | }
157 | 
158 | /**
159 |  * 
160 |  * @param {string} name 用户名
161 |  * @param {string} color 用户颜色
162 |  * @param {number} ccfLevel 用户ccf等级
163 |  * @param {string} title 标题的后缀
164 |  * @param {string} rightTop 右上角的标签（展示总数）
165 |  */
166 | const renderNameTitle = (name, color, ccfLevel, title, cardWidth, rightTop, tag) => {
167 |     if(tag=="null")
168 |     {
169 |         tag="";
170 |     }
171 |     if(color=="Cheater")
172 |     {
173 |         tag="作弊者";
174 |     }
175 |     const tagLength = anafanafo(tag)/10*1.2;
176 |     const nameLength = anafanafo(name)/10*1.8;
177 |     const nameColor = NAMECOLOR[color];
178 |     const tagSVG = tag?`<defs><filter x="-0.05" y="-0.05" width="1.1" height="1.1" id="tagFilter"><feFlood flood-color="${nameColor}"/><feComposite in="SourceGraphic"/></filter></defs><text filter="url(#tagFilter)" x="${nameLength + (ccfLevel < 3 ? 10 : 28)}" y="-1" fill="white" font-weight="bold" textLength="${tagLength}" font-size="12">${tag}</text>`:``;
179 | 
180 |     return `
181 |     <g transform="translate(0, 0)" font-family="Verdana, Microsoft Yahei" text-rendering="geometricPrecision">
182 |         <text x="0" y="0" fill="${nameColor}" font-weight="bold" textLength="${nameLength}" font-size="18">
183 |             ${name}
184 |         </text>
185 |         ${ccfLevel < 3 ? "" : renderCCFBadge(ccfLevel, nameLength + 5)}
186 |         ${tagSVG}
187 |         <text x="${nameLength + (ccfLevel < 3 ? 10 : 28) + (tag?tagLength+5:0)}" y="0" class="title" font-weight="normal" font-size="18">
188 |             ${title}
189 |         </text>
190 |         <text x="${cardWidth - 160}" y="0" class="title" font-weight="normal" font-size="13px">
191 |             ${rightTop}
192 |         </text>
193 |     </g>`;
194 | }
195 | 
196 | /**
197 |  * 
198 |  * @param {string} userType 用户类型
199 |  * @param {number} followerCount 粉丝数量
200 |  * @param {number} followingCount 此用户关注的人数
201 |  * @param {number} ranking 咕值排名
202 |  * @param {string} slogan 个性签名
203 |  */
204 | const renderAboutText = (userType,followerCount,followingCount,ranking,slogan,darkmode=false) => {
205 |     var iconColor = darkmode?"#ffffff":"#000000";
206 |     let icons = `<svg t="1615610084159" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="2114" width="16" height="16" x="0" y="3"><path d="M511.82655 556.277436c-135.928832 0-246.477624-110.546745-246.477624-246.477624S375.896694 63.322188 511.82655 63.322188c135.930879 0 246.477624 110.546745 246.477624 246.477624S647.757428 556.277436 511.82655 556.277436zM511.82655 108.135836c-111.202685 0-201.662953 90.481757-201.662953 201.662953s90.460268 201.662953 201.662953 201.662953c111.159706 0 201.662953-90.481757 201.662953-201.662953S622.986255 108.135836 511.82655 108.135836z" p-id="2115" fill="${iconColor}"></path><path d="M870.340853 959.603341 153.314293 959.603341c-37.068244 0-67.220984-30.15274-67.220984-67.220984 0-3.061732 0.656963-75.535347 54.923914-147.879002 31.596625-42.143842 74.835406-75.578326 128.576377-99.474572 65.559135-29.143761 147.091056-43.937698 242.23295-43.937698 95.14394 0 176.630836 14.792914 242.276952 43.937698 53.741995 23.896246 96.980775 57.33073 128.577401 99.474572 54.266951 72.342632 54.880935 144.81727 54.880935 147.879002C937.561837 929.4506 907.409097 959.603341 870.340853 959.603341zM511.82655 645.905756c-156.280346 0-271.553743 42.712801-333.436138 123.501802-46.38954 60.567447-47.439452 122.449843-47.483454 123.062803 0 12.254092 10.021238 22.320355 22.406313 22.320355l717.02656 0c12.341073 0 22.407336-10.066263 22.407336-22.407336 0-0.524956-1.050935-62.406329-47.440475-122.974799C783.33629 688.618557 668.063917 645.905756 511.82655 645.905756z" p-id="2116" fill="${iconColor}"></path></svg><svg t="1615610802149" class="icon" viewBox="0 0 1201 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="2977" width="16" height="16" x="0" y="33"><path d="M903.62324902 526.69698945L548.15650859 882.26979013l-348.82030019-347.64185302c-93.17980107-93.20336982-96.00807393-247.83917959-6.16327735-337.69576055 91.30607051-91.22357901 239.99072344-92.01313828 331.55605195-1.75588594a32.99651455 32.99651455 0 0 0 46.25404278 0.10606026A234.36953086 234.36953086 0 0 1 734.30399023 128.34656387a32.99651455 32.99651455 0 0 0 32.85510118-33.19685069c-0.09427588-18.24235927-15.31981055-33.12614443-33.19685069-32.85510117a299.92653545 299.92653545 0 0 0-185.95892988 65.2977457C429.97006338 33.06912734 255.91344717 40.79973887 146.51821602 150.20675528c-113.5197958 113.5197958-112.41205576 306.9500792 1.69696318 426.53887646a43.6025373 43.6025373 0 0 0 5.46799395 5.89223496c0.81312803 0.75420615 1.63804131 1.43770518 2.46295458 2.09763545l368.73605303 367.59295986a32.99651455 32.99651455 0 0 0 46.67828467 0l378.74106826-378.87069727a33.02715411 33.02715411 0 0 0-46.7136378-46.70185253z" fill="${iconColor}" p-id="2978"></path><path d="M1085.03337412 221.10212393h-125.03322246V96.03354834a33.02597636 33.02597636 0 1 0-66.05195186 0v125.06857559H768.92676172a32.99651455 32.99651455 0 1 0 0 65.99302998h125.02143808v125.04500684a33.02597636 33.02597636 0 1 0 66.05195186-1e-8V287.09515391h125.03322246a32.99651455 32.99651455 0 0 0 0-65.99302998z" fill="${iconColor}" p-id="2979"></path></svg><svg t="1615610889864" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="3714" width="16" height="16" x="0" y="63"><path d="M924 467.1H768.2c-10.8 0-19.5 8.7-19.5 19.5s8.7 19.5 19.5 19.5h136.3v331.1H690.3V175c0-21.5-17.4-38.9-38.9-38.9H378.7c-21.5 0-38.9 17.4-38.9 38.9v662.1H125.6V408.7h136.3c10.8 0 19.5-8.7 19.5-19.5s-8.7-19.5-19.5-19.5H106.1c-10.8 0-19.5 8.7-19.5 19.5v467.4c0 10.8 8.7 19.5 19.5 19.5H924c10.8 0 19.5-8.7 19.5-19.5v-370c0-10.8-8.8-19.5-19.5-19.5z m-272.6 370H378.7V213.9c0-21.5 17.4-38.9 38.9-38.9h194.7c21.5 0 38.9 17.4 38.9 38.9v623.2zM456.6 311.3v19.5H515v97.4h39V252.9h-39l-58.4 58.4z" p-id="3715" fill="${iconColor}"></path></svg><svg t="1615610958838" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="5348" width="16" height="16" x="0" y="93"><path d="M875.126 133.297c-28.672-28.673-66.796-44.464-107.352-44.464-40.545 0-78.667 15.79-107.344 44.464L183.644 610.09c-22.65 22.637-76.64 163.393-117.947 277.491-4.598 12.727-1.668 26.723 7.642 36.524 6.667 7.03 16.051 11.062 25.746 11.062 3.516 0 7.004-0.521 10.353-1.547 118.15-36.01 264.179-84.123 288.894-108.83l476.794-476.797c59.187-59.192 59.187-155.505 0-214.696M313.34 789.995c-35.18 13.91-91.74 33.58-155.918 54.2 23.282-61.807 45.067-116.267 60.022-150.096l95.896 95.896z m378.072-358.698L373.234 749.474 258.958 635.198l318.176-318.183 114.279 114.282z m75.981-75.98l-25.773 25.77-114.28-114.278 25.77-25.773 114.283 114.28z m57.526-57.526l-7.321 7.319L703.32 190.828l7.316-7.32c15.26-15.261 35.551-23.666 57.137-23.666s41.88 8.407 57.143 23.667c31.505 31.505 31.505 82.773 0.003 114.282M924.94 857.775H451.812c-19.577 0-35.502 15.926-35.502 35.502s15.926 35.502 35.502 35.502h473.126c19.577 0 35.503-15.926 35.503-35.502s-15.926-35.502-35.503-35.502" p-id="5349" fill="${iconColor}"></path></svg>
207 |                             `
208 |     let line1 = `<g transform="translate(25,0)"><text x="0" y="15" class="about-text">用户类型：${userType}</text></g>`
209 |     let line2 = `<g transform="translate(25,30)"><text x="0" y="15" class="about-text">TA关注了${followingCount}人，共有${followerCount}人关注TA</text></g>`
210 |     let line3 = `<g transform="translate(25,60)"><text x="0" y="15" class="about-text">咕值排名：第${ranking}名</text></g>`
211 |     let line4 = "";
212 |     if(slogan)
213 |     {
214 |         line4 = `<g transform="translate(25,90)"><text x="0" y="15" class="about-text">${slogan}</text></g>`
215 |     }
216 |     else
217 |     {
218 |         line4 = `<g transform="translate(25,90)"><text x="0" y="15" class="about-text-grey">这个人很懒，连个性签名也懒得写</text></g>`
219 |     }
220 |     return icons+line1+line2+line3+line4;
221 | }
222 | module.exports = { 
223 |     NAMECOLOR,
224 |     Card,
225 |     renderError,
226 |     renderCCFBadge,
227 |     renderChart,
228 |     renderNameTitle,
229 |     renderAboutText
230 | };
231 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
  1 |                   GNU LESSER GENERAL PUBLIC LICENSE
  2 |                        Version 2.1, February 1999
  3 | 
  4 |  Copyright (C) 1991, 1999 Free Software Foundation, Inc.
  5 |  51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  6 |  Everyone is permitted to copy and distribute verbatim copies
  7 |  of this license document, but changing it is not allowed.
  8 | 
  9 | [This is the first released version of the Lesser GPL.  It also counts
 10 |  as the successor of the GNU Library Public License, version 2, hence
 11 |  the version number 2.1.]
 12 | 
 13 |                             Preamble
 14 | 
 15 |   The licenses for most software are designed to take away your
 16 | freedom to share and change it.  By contrast, the GNU General Public
 17 | Licenses are intended to guarantee your freedom to share and change
 18 | free software--to make sure the software is free for all its users.
 19 | 
 20 |   This license, the Lesser General Public License, applies to some
 21 | specially designated software packages--typically libraries--of the
 22 | Free Software Foundation and other authors who decide to use it.  You
 23 | can use it too, but we suggest you first think carefully about whether
 24 | this license or the ordinary General Public License is the better
 25 | strategy to use in any particular case, based on the explanations below.
 26 | 
 27 |   When we speak of free software, we are referring to freedom of use,
 28 | not price.  Our General Public Licenses are designed to make sure that
 29 | you have the freedom to distribute copies of free software (and charge
 30 | for this service if you wish); that you receive source code or can get
 31 | it if you want it; that you can change the software and use pieces of
 32 | it in new free programs; and that you are informed that you can do
 33 | these things.
 34 | 
 35 |   To protect your rights, we need to make restrictions that forbid
 36 | distributors to deny you these rights or to ask you to surrender these
 37 | rights.  These restrictions translate to certain responsibilities for
 38 | you if you distribute copies of the library or if you modify it.
 39 | 
 40 |   For example, if you distribute copies of the library, whether gratis
 41 | or for a fee, you must give the recipients all the rights that we gave
 42 | you.  You must make sure that they, too, receive or can get the source
 43 | code.  If you link other code with the library, you must provide
 44 | complete object files to the recipients, so that they can relink them
 45 | with the library after making changes to the library and recompiling
 46 | it.  And you must show them these terms so they know their rights.
 47 | 
 48 |   We protect your rights with a two-step method: (1) we copyright the
 49 | library, and (2) we offer you this license, which gives you legal
 50 | permission to copy, distribute and/or modify the library.
 51 | 
 52 |   To protect each distributor, we want to make it very clear that
 53 | there is no warranty for the free library.  Also, if the library is
 54 | modified by someone else and passed on, the recipients should know
 55 | that what they have is not the original version, so that the original
 56 | author's reputation will not be affected by problems that might be
 57 | introduced by others.
 58 | 
 59 |   Finally, software patents pose a constant threat to the existence of
 60 | any free program.  We wish to make sure that a company cannot
 61 | effectively restrict the users of a free program by obtaining a
 62 | restrictive license from a patent holder.  Therefore, we insist that
 63 | any patent license obtained for a version of the library must be
 64 | consistent with the full freedom of use specified in this license.
 65 | 
 66 |   Most GNU software, including some libraries, is covered by the
 67 | ordinary GNU General Public License.  This license, the GNU Lesser
 68 | General Public License, applies to certain designated libraries, and
 69 | is quite different from the ordinary General Public License.  We use
 70 | this license for certain libraries in order to permit linking those
 71 | libraries into non-free programs.
 72 | 
 73 |   When a program is linked with a library, whether statically or using
 74 | a shared library, the combination of the two is legally speaking a
 75 | combined work, a derivative of the original library.  The ordinary
 76 | General Public License therefore permits such linking only if the
 77 | entire combination fits its criteria of freedom.  The Lesser General
 78 | Public License permits more lax criteria for linking other code with
 79 | the library.
 80 | 
 81 |   We call this license the "Lesser" General Public License because it
 82 | does Less to protect the user's freedom than the ordinary General
 83 | Public License.  It also provides other free software developers Less
 84 | of an advantage over competing non-free programs.  These disadvantages
 85 | are the reason we use the ordinary General Public License for many
 86 | libraries.  However, the Lesser license provides advantages in certain
 87 | special circumstances.
 88 | 
 89 |   For example, on rare occasions, there may be a special need to
 90 | encourage the widest possible use of a certain library, so that it becomes
 91 | a de-facto standard.  To achieve this, non-free programs must be
 92 | allowed to use the library.  A more frequent case is that a free
 93 | library does the same job as widely used non-free libraries.  In this
 94 | case, there is little to gain by limiting the free library to free
 95 | software only, so we use the Lesser General Public License.
 96 | 
 97 |   In other cases, permission to use a particular library in non-free
 98 | programs enables a greater number of people to use a large body of
 99 | free software.  For example, permission to use the GNU C Library in
100 | non-free programs enables many more people to use the whole GNU
101 | operating system, as well as its variant, the GNU/Linux operating
102 | system.
103 | 
104 |   Although the Lesser General Public License is Less protective of the
105 | users' freedom, it does ensure that the user of a program that is
106 | linked with the Library has the freedom and the wherewithal to run
107 | that program using a modified version of the Library.
108 | 
109 |   The precise terms and conditions for copying, distribution and
110 | modification follow.  Pay close attention to the difference between a
111 | "work based on the library" and a "work that uses the library".  The
112 | former contains code derived from the library, whereas the latter must
113 | be combined with the library in order to run.
114 | 
115 |                   GNU LESSER GENERAL PUBLIC LICENSE
116 |    TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
117 | 
118 |   0. This License Agreement applies to any software library or other
119 | program which contains a notice placed by the copyright holder or
120 | other authorized party saying it may be distributed under the terms of
121 | this Lesser General Public License (also called "this License").
122 | Each licensee is addressed as "you".
123 | 
124 |   A "library" means a collection of software functions and/or data
125 | prepared so as to be conveniently linked with application programs
126 | (which use some of those functions and data) to form executables.
127 | 
128 |   The "Library", below, refers to any such software library or work
129 | which has been distributed under these terms.  A "work based on the
130 | Library" means either the Library or any derivative work under
131 | copyright law: that is to say, a work containing the Library or a
132 | portion of it, either verbatim or with modifications and/or translated
133 | straightforwardly into another language.  (Hereinafter, translation is
134 | included without limitation in the term "modification".)
135 | 
136 |   "Source code" for a work means the preferred form of the work for
137 | making modifications to it.  For a library, complete source code means
138 | all the source code for all modules it contains, plus any associated
139 | interface definition files, plus the scripts used to control compilation
140 | and installation of the library.
141 | 
142 |   Activities other than copying, distribution and modification are not
143 | covered by this License; they are outside its scope.  The act of
144 | running a program using the Library is not restricted, and output from
145 | such a program is covered only if its contents constitute a work based
146 | on the Library (independent of the use of the Library in a tool for
147 | writing it).  Whether that is true depends on what the Library does
148 | and what the program that uses the Library does.
149 | 
150 |   1. You may copy and distribute verbatim copies of the Library's
151 | complete source code as you receive it, in any medium, provided that
152 | you conspicuously and appropriately publish on each copy an
153 | appropriate copyright notice and disclaimer of warranty; keep intact
154 | all the notices that refer to this License and to the absence of any
155 | warranty; and distribute a copy of this License along with the
156 | Library.
157 | 
158 |   You may charge a fee for the physical act of transferring a copy,
159 | and you may at your option offer warranty protection in exchange for a
160 | fee.
161 | 
162 |   2. You may modify your copy or copies of the Library or any portion
163 | of it, thus forming a work based on the Library, and copy and
164 | distribute such modifications or work under the terms of Section 1
165 | above, provided that you also meet all of these conditions:
166 | 
167 |     a) The modified work must itself be a software library.
168 | 
169 |     b) You must cause the files modified to carry prominent notices
170 |     stating that you changed the files and the date of any change.
171 | 
172 |     c) You must cause the whole of the work to be licensed at no
173 |     charge to all third parties under the terms of this License.
174 | 
175 |     d) If a facility in the modified Library refers to a function or a
176 |     table of data to be supplied by an application program that uses
177 |     the facility, other than as an argument passed when the facility
178 |     is invoked, then you must make a good faith effort to ensure that,
179 |     in the event an application does not supply such function or
180 |     table, the facility still operates, and performs whatever part of
181 |     its purpose remains meaningful.
182 | 
183 |     (For example, a function in a library to compute square roots has
184 |     a purpose that is entirely well-defined independent of the
185 |     application.  Therefore, Subsection 2d requires that any
186 |     application-supplied function or table used by this function must
187 |     be optional: if the application does not supply it, the square
188 |     root function must still compute square roots.)
189 | 
190 | These requirements apply to the modified work as a whole.  If
191 | identifiable sections of that work are not derived from the Library,
192 | and can be reasonably considered independent and separate works in
193 | themselves, then this License, and its terms, do not apply to those
194 | sections when you distribute them as separate works.  But when you
195 | distribute the same sections as part of a whole which is a work based
196 | on the Library, the distribution of the whole must be on the terms of
197 | this License, whose permissions for other licensees extend to the
198 | entire whole, and thus to each and every part regardless of who wrote
199 | it.
200 | 
201 | Thus, it is not the intent of this section to claim rights or contest
202 | your rights to work written entirely by you; rather, the intent is to
203 | exercise the right to control the distribution of derivative or
204 | collective works based on the Library.
205 | 
206 | In addition, mere aggregation of another work not based on the Library
207 | with the Library (or with a work based on the Library) on a volume of
208 | a storage or distribution medium does not bring the other work under
209 | the scope of this License.
210 | 
211 |   3. You may opt to apply the terms of the ordinary GNU General Public
212 | License instead of this License to a given copy of the Library.  To do
213 | this, you must alter all the notices that refer to this License, so
214 | that they refer to the ordinary GNU General Public License, version 2,
215 | instead of to this License.  (If a newer version than version 2 of the
216 | ordinary GNU General Public License has appeared, then you can specify
217 | that version instead if you wish.)  Do not make any other change in
218 | these notices.
219 | 
220 |   Once this change is made in a given copy, it is irreversible for
221 | that copy, so the ordinary GNU General Public License applies to all
222 | subsequent copies and derivative works made from that copy.
223 | 
224 |   This option is useful when you wish to copy part of the code of
225 | the Library into a program that is not a library.
226 | 
227 |   4. You may copy and distribute the Library (or a portion or
228 | derivative of it, under Section 2) in object code or executable form
229 | under the terms of Sections 1 and 2 above provided that you accompany
230 | it with the complete corresponding machine-readable source code, which
231 | must be distributed under the terms of Sections 1 and 2 above on a
232 | medium customarily used for software interchange.
233 | 
234 |   If distribution of object code is made by offering access to copy
235 | from a designated place, then offering equivalent access to copy the
236 | source code from the same place satisfies the requirement to
237 | distribute the source code, even though third parties are not
238 | compelled to copy the source along with the object code.
239 | 
240 |   5. A program that contains no derivative of any portion of the
241 | Library, but is designed to work with the Library by being compiled or
242 | linked with it, is called a "work that uses the Library".  Such a
243 | work, in isolation, is not a derivative work of the Library, and
244 | therefore falls outside the scope of this License.
245 | 
246 |   However, linking a "work that uses the Library" with the Library
247 | creates an executable that is a derivative of the Library (because it
248 | contains portions of the Library), rather than a "work that uses the
249 | library".  The executable is therefore covered by this License.
250 | Section 6 states terms for distribution of such executables.
251 | 
252 |   When a "work that uses the Library" uses material from a header file
253 | that is part of the Library, the object code for the work may be a
254 | derivative work of the Library even though the source code is not.
255 | Whether this is true is especially significant if the work can be
256 | linked without the Library, or if the work is itself a library.  The
257 | threshold for this to be true is not precisely defined by law.
258 | 
259 |   If such an object file uses only numerical parameters, data
260 | structure layouts and accessors, and small macros and small inline
261 | functions (ten lines or less in length), then the use of the object
262 | file is unrestricted, regardless of whether it is legally a derivative
263 | work.  (Executables containing this object code plus portions of the
264 | Library will still fall under Section 6.)
265 | 
266 |   Otherwise, if the work is a derivative of the Library, you may
267 | distribute the object code for the work under the terms of Section 6.
268 | Any executables containing that work also fall under Section 6,
269 | whether or not they are linked directly with the Library itself.
270 | 
271 |   6. As an exception to the Sections above, you may also combine or
272 | link a "work that uses the Library" with the Library to produce a
273 | work containing portions of the Library, and distribute that work
274 | under terms of your choice, provided that the terms permit
275 | modification of the work for the customer's own use and reverse
276 | engineering for debugging such modifications.
277 | 
278 |   You must give prominent notice with each copy of the work that the
279 | Library is used in it and that the Library and its use are covered by
280 | this License.  You must supply a copy of this License.  If the work
281 | during execution displays copyright notices, you must include the
282 | copyright notice for the Library among them, as well as a reference
283 | directing the user to the copy of this License.  Also, you must do one
284 | of these things:
285 | 
286 |     a) Accompany the work with the complete corresponding
287 |     machine-readable source code for the Library including whatever
288 |     changes were used in the work (which must be distributed under
289 |     Sections 1 and 2 above); and, if the work is an executable linked
290 |     with the Library, with the complete machine-readable "work that
291 |     uses the Library", as object code and/or source code, so that the
292 |     user can modify the Library and then relink to produce a modified
293 |     executable containing the modified Library.  (It is understood
294 |     that the user who changes the contents of definitions files in the
295 |     Library will not necessarily be able to recompile the application
296 |     to use the modified definitions.)
297 | 
298 |     b) Use a suitable shared library mechanism for linking with the
299 |     Library.  A suitable mechanism is one that (1) uses at run time a
300 |     copy of the library already present on the user's computer system,
301 |     rather than copying library functions into the executable, and (2)
302 |     will operate properly with a modified version of the library, if
303 |     the user installs one, as long as the modified version is
304 |     interface-compatible with the version that the work was made with.
305 | 
306 |     c) Accompany the work with a written offer, valid for at
307 |     least three years, to give the same user the materials
308 |     specified in Subsection 6a, above, for a charge no more
309 |     than the cost of performing this distribution.
310 | 
311 |     d) If distribution of the work is made by offering access to copy
312 |     from a designated place, offer equivalent access to copy the above
313 |     specified materials from the same place.
314 | 
315 |     e) Verify that the user has already received a copy of these
316 |     materials or that you have already sent this user a copy.
317 | 
318 |   For an executable, the required form of the "work that uses the
319 | Library" must include any data and utility programs needed for
320 | reproducing the executable from it.  However, as a special exception,
321 | the materials to be distributed need not include anything that is
322 | normally distributed (in either source or binary form) with the major
323 | components (compiler, kernel, and so on) of the operating system on
324 | which the executable runs, unless that component itself accompanies
325 | the executable.
326 | 
327 |   It may happen that this requirement contradicts the license
328 | restrictions of other proprietary libraries that do not normally
329 | accompany the operating system.  Such a contradiction means you cannot
330 | use both them and the Library together in an executable that you
331 | distribute.
332 | 
333 |   7. You may place library facilities that are a work based on the
334 | Library side-by-side in a single library together with other library
335 | facilities not covered by this License, and distribute such a combined
336 | library, provided that the separate distribution of the work based on
337 | the Library and of the other library facilities is otherwise
338 | permitted, and provided that you do these two things:
339 | 
340 |     a) Accompany the combined library with a copy of the same work
341 |     based on the Library, uncombined with any other library
342 |     facilities.  This must be distributed under the terms of the
343 |     Sections above.
344 | 
345 |     b) Give prominent notice with the combined library of the fact
346 |     that part of it is a work based on the Library, and explaining
347 |     where to find the accompanying uncombined form of the same work.
348 | 
349 |   8. You may not copy, modify, sublicense, link with, or distribute
350 | the Library except as expressly provided under this License.  Any
351 | attempt otherwise to copy, modify, sublicense, link with, or
352 | distribute the Library is void, and will automatically terminate your
353 | rights under this License.  However, parties who have received copies,
354 | or rights, from you under this License will not have their licenses
355 | terminated so long as such parties remain in full compliance.
356 | 
357 |   9. You are not required to accept this License, since you have not
358 | signed it.  However, nothing else grants you permission to modify or
359 | distribute the Library or its derivative works.  These actions are
360 | prohibited by law if you do not accept this License.  Therefore, by
361 | modifying or distributing the Library (or any work based on the
362 | Library), you indicate your acceptance of this License to do so, and
363 | all its terms and conditions for copying, distributing or modifying
364 | the Library or works based on it.
365 | 
366 |   10. Each time you redistribute the Library (or any work based on the
367 | Library), the recipient automatically receives a license from the
368 | original licensor to copy, distribute, link with or modify the Library
369 | subject to these terms and conditions.  You may not impose any further
370 | restrictions on the recipients' exercise of the rights granted herein.
371 | You are not responsible for enforcing compliance by third parties with
372 | this License.
373 | 
374 |   11. If, as a consequence of a court judgment or allegation of patent
375 | infringement or for any other reason (not limited to patent issues),
376 | conditions are imposed on you (whether by court order, agreement or
377 | otherwise) that contradict the conditions of this License, they do not
378 | excuse you from the conditions of this License.  If you cannot
379 | distribute so as to satisfy simultaneously your obligations under this
380 | License and any other pertinent obligations, then as a consequence you
381 | may not distribute the Library at all.  For example, if a patent
382 | license would not permit royalty-free redistribution of the Library by
383 | all those who receive copies directly or indirectly through you, then
384 | the only way you could satisfy both it and this License would be to
385 | refrain entirely from distribution of the Library.
386 | 
387 | If any portion of this section is held invalid or unenforceable under any
388 | particular circumstance, the balance of the section is intended to apply,
389 | and the section as a whole is intended to apply in other circumstances.
390 | 
391 | It is not the purpose of this section to induce you to infringe any
392 | patents or other property right claims or to contest validity of any
393 | such claims; this section has the sole purpose of protecting the
394 | integrity of the free software distribution system which is
395 | implemented by public license practices.  Many people have made
396 | generous contributions to the wide range of software distributed
397 | through that system in reliance on consistent application of that
398 | system; it is up to the author/donor to decide if he or she is willing
399 | to distribute software through any other system and a licensee cannot
400 | impose that choice.
401 | 
402 | This section is intended to make thoroughly clear what is believed to
403 | be a consequence of the rest of this License.
404 | 
405 |   12. If the distribution and/or use of the Library is restricted in
406 | certain countries either by patents or by copyrighted interfaces, the
407 | original copyright holder who places the Library under this License may add
408 | an explicit geographical distribution limitation excluding those countries,
409 | so that distribution is permitted only in or among countries not thus
410 | excluded.  In such case, this License incorporates the limitation as if
411 | written in the body of this License.
412 | 
413 |   13. The Free Software Foundation may publish revised and/or new
414 | versions of the Lesser General Public License from time to time.
415 | Such new versions will be similar in spirit to the present version,
416 | but may differ in detail to address new problems or concerns.
417 | 
418 | Each version is given a distinguishing version number.  If the Library
419 | specifies a version number of this License which applies to it and
420 | "any later version", you have the option of following the terms and
421 | conditions either of that version or of any later version published by
422 | the Free Software Foundation.  If the Library does not specify a
423 | license version number, you may choose any version ever published by
424 | the Free Software Foundation.
425 | 
426 |   14. If you wish to incorporate parts of the Library into other free
427 | programs whose distribution conditions are incompatible with these,
428 | write to the author to ask for permission.  For software which is
429 | copyrighted by the Free Software Foundation, write to the Free
430 | Software Foundation; we sometimes make exceptions for this.  Our
431 | decision will be guided by the two goals of preserving the free status
432 | of all derivatives of our free software and of promoting the sharing
433 | and reuse of software generally.
434 | 
435 |                             NO WARRANTY
436 | 
437 |   15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
438 | WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
439 | EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
440 | OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
441 | KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
442 | IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
443 | PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
444 | LIBRARY IS WITH YOU.  SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
445 | THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
446 | 
447 |   16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
448 | WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
449 | AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
450 | FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
451 | CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
452 | LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
453 | RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
454 | FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
455 | SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
456 | DAMAGES.
457 | 
458 |                      END OF TERMS AND CONDITIONS
459 | 
460 |            How to Apply These Terms to Your New Libraries
461 | 
462 |   If you develop a new library, and you want it to be of the greatest
463 | possible use to the public, we recommend making it free software that
464 | everyone can redistribute and change.  You can do so by permitting
465 | redistribution under these terms (or, alternatively, under the terms of the
466 | ordinary General Public License).
467 | 
468 |   To apply these terms, attach the following notices to the library.  It is
469 | safest to attach them to the start of each source file to most effectively
470 | convey the exclusion of warranty; and each file should have at least the
471 | "copyright" line and a pointer to where the full notice is found.
472 | 
473 |     <one line to give the library's name and a brief idea of what it does.>
474 |     Copyright (C) <year>  <name of author>
475 | 
476 |     This library is free software; you can redistribute it and/or
477 |     modify it under the terms of the GNU Lesser General Public
478 |     License as published by the Free Software Foundation; either
479 |     version 2.1 of the License, or (at your option) any later version.
480 | 
481 |     This library is distributed in the hope that it will be useful,
482 |     but WITHOUT ANY WARRANTY; without even the implied warranty of
483 |     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
484 |     Lesser General Public License for more details.
485 | 
486 |     You should have received a copy of the GNU Lesser General Public
487 |     License along with this library; if not, write to the Free Software
488 |     Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301
489 |     USA
490 | 
491 | Also add information on how to contact you by electronic and paper mail.
492 | 
493 | You should also get your employer (if you work as a programmer) or your
494 | school, if any, to sign a "copyright disclaimer" for the library, if
495 | necessary.  Here is a sample; alter the names:
496 | 
497 |   Yoyodyne, Inc., hereby disclaims all copyright interest in the
498 |   library `Frob' (a library for tweaking knobs) written by James Random
499 |   Hacker.
500 | 
501 |   <signature of Ty Coon>, 1 April 1990
502 |   Ty Coon, President of Vice
503 | 
504 | That's all there is to it!
505 | 


--------------------------------------------------------------------------------