From 68adb1014c70ceaffbf7deaf5a8032750f6f3415 Mon Sep 17 00:00:00 2001 From: SouthFox Date: Wed, 15 Feb 2023 21:17:41 +0800 Subject: [PATCH] init --- Pipfile | 16 + Pipfile.lock | 499 +++++++++++++++++++++++++++++++ docs/advanced.md | 95 ++++++ docs/base.md | 111 +++++++ docs/content.md | 44 +++ docs/fedi.md | 30 ++ docs/img/01.png | 3 + docs/img/02.png | 3 + docs/img/03.png | 3 + docs/img/04.png | 3 + docs/img/05.png | 3 + docs/img/06.png | 3 + docs/img/07.png | 3 + docs/img/08.png | 3 + docs/img/09.png | 3 + docs/img/10.png | 3 + docs/img/11.png | 3 + docs/img/12.png | 3 + docs/img/123.png | 3 + docs/img/13.png | 3 + docs/img/14.png | 3 + docs/img/15.png | 3 + docs/img/16.png | 3 + docs/img/17.png | 3 + docs/img/18.png | 3 + docs/img/19.png | 3 + docs/index.md | 28 ++ docs/site.md | 34 +++ docs/user.md | 49 +++ mkdocs.yml | 32 ++ overrides/partials/comments.html | 10 + 31 files changed, 1008 insertions(+) create mode 100644 Pipfile create mode 100644 Pipfile.lock create mode 100644 docs/advanced.md create mode 100644 docs/base.md create mode 100644 docs/content.md create mode 100644 docs/fedi.md create mode 100644 docs/img/01.png create mode 100644 docs/img/02.png create mode 100644 docs/img/03.png create mode 100644 docs/img/04.png create mode 100644 docs/img/05.png create mode 100644 docs/img/06.png create mode 100644 docs/img/07.png create mode 100644 docs/img/08.png create mode 100644 docs/img/09.png create mode 100644 docs/img/10.png create mode 100644 docs/img/11.png create mode 100644 docs/img/12.png create mode 100644 docs/img/123.png create mode 100644 docs/img/13.png create mode 100644 docs/img/14.png create mode 100644 docs/img/15.png create mode 100644 docs/img/16.png create mode 100644 docs/img/17.png create mode 100644 docs/img/18.png create mode 100644 docs/img/19.png create mode 100644 docs/index.md create mode 100644 docs/site.md create mode 100644 docs/user.md create mode 100644 mkdocs.yml create mode 100644 overrides/partials/comments.html diff --git a/Pipfile b/Pipfile new file mode 100644 index 0000000..524aae4 --- /dev/null +++ b/Pipfile @@ -0,0 +1,16 @@ +[[source]] +url = "https://pypi.org/simple" +verify_ssl = true +name = "pypi" + +[packages] +mkdocs = "*" +mkdocs-material = "*" +jieba = "*" +pillow = "*" +cairosvg = "*" + +[dev-packages] + +[requires] +python_version = "3.10" diff --git a/Pipfile.lock b/Pipfile.lock new file mode 100644 index 0000000..537f42c --- /dev/null +++ b/Pipfile.lock @@ -0,0 +1,499 @@ +{ + "_meta": { + "hash": { + "sha256": "0787a602efb4836d1cb5a58fb387023983c964181b356123d6e0c4aad52c3783" + }, + "pipfile-spec": 6, + "requires": { + "python_version": "3.10" + }, + "sources": [ + { + "name": "pypi", + "url": "https://pypi.org/simple", + "verify_ssl": true + } + ] + }, + "default": { + "cairocffi": { + "hashes": [ + "sha256:509339b32ccd8d7b00c2204c32736cde78db53a32e6a162d312478d25626cd9a" + ], + "markers": "python_version >= '3.7'", + "version": "==1.4.0" + }, + "cairosvg": { + "hashes": [ + "sha256:98c276b7e4f0caf01e5c7176765c104ffa1aa1461d63b2053b04ab663cf7052b", + "sha256:b0b9929cf5dba005178d746a8036fcf0025550f498ca54db61873322384783bc" + ], + "index": "pypi", + "version": "==2.5.2" + }, + "certifi": { + "hashes": [ + "sha256:0d9c601124e5a6ba9712dbc60d9c53c21e34f5f641fe83002317394311bdce14", + "sha256:90c1a32f1d68f940488354e36370f6cca89f0f106db09518524c88d6ed83f382" + ], + "markers": "python_version >= '3.6'", + "version": "==2022.9.24" + }, + "cffi": { + "hashes": [ + "sha256:00a9ed42e88df81ffae7a8ab6d9356b371399b91dbdf0c3cb1e84c03a13aceb5", + "sha256:03425bdae262c76aad70202debd780501fabeaca237cdfddc008987c0e0f59ef", + "sha256:04ed324bda3cda42b9b695d51bb7d54b680b9719cfab04227cdd1e04e5de3104", + "sha256:0e2642fe3142e4cc4af0799748233ad6da94c62a8bec3a6648bf8ee68b1c7426", + "sha256:173379135477dc8cac4bc58f45db08ab45d228b3363adb7af79436135d028405", + "sha256:198caafb44239b60e252492445da556afafc7d1e3ab7a1fb3f0584ef6d742375", + "sha256:1e74c6b51a9ed6589199c787bf5f9875612ca4a8a0785fb2d4a84429badaf22a", + "sha256:2012c72d854c2d03e45d06ae57f40d78e5770d252f195b93f581acf3ba44496e", + "sha256:21157295583fe8943475029ed5abdcf71eb3911894724e360acff1d61c1d54bc", + "sha256:2470043b93ff09bf8fb1d46d1cb756ce6132c54826661a32d4e4d132e1977adf", + "sha256:285d29981935eb726a4399badae8f0ffdff4f5050eaa6d0cfc3f64b857b77185", + "sha256:30d78fbc8ebf9c92c9b7823ee18eb92f2e6ef79b45ac84db507f52fbe3ec4497", + "sha256:320dab6e7cb2eacdf0e658569d2575c4dad258c0fcc794f46215e1e39f90f2c3", + "sha256:33ab79603146aace82c2427da5ca6e58f2b3f2fb5da893ceac0c42218a40be35", + "sha256:3548db281cd7d2561c9ad9984681c95f7b0e38881201e157833a2342c30d5e8c", + "sha256:3799aecf2e17cf585d977b780ce79ff0dc9b78d799fc694221ce814c2c19db83", + "sha256:39d39875251ca8f612b6f33e6b1195af86d1b3e60086068be9cc053aa4376e21", + "sha256:3b926aa83d1edb5aa5b427b4053dc420ec295a08e40911296b9eb1b6170f6cca", + "sha256:3bcde07039e586f91b45c88f8583ea7cf7a0770df3a1649627bf598332cb6984", + "sha256:3d08afd128ddaa624a48cf2b859afef385b720bb4b43df214f85616922e6a5ac", + "sha256:3eb6971dcff08619f8d91607cfc726518b6fa2a9eba42856be181c6d0d9515fd", + "sha256:40f4774f5a9d4f5e344f31a32b5096977b5d48560c5592e2f3d2c4374bd543ee", + "sha256:4289fc34b2f5316fbb762d75362931e351941fa95fa18789191b33fc4cf9504a", + "sha256:470c103ae716238bbe698d67ad020e1db9d9dba34fa5a899b5e21577e6d52ed2", + "sha256:4f2c9f67e9821cad2e5f480bc8d83b8742896f1242dba247911072d4fa94c192", + "sha256:50a74364d85fd319352182ef59c5c790484a336f6db772c1a9231f1c3ed0cbd7", + "sha256:54a2db7b78338edd780e7ef7f9f6c442500fb0d41a5a4ea24fff1c929d5af585", + "sha256:5635bd9cb9731e6d4a1132a498dd34f764034a8ce60cef4f5319c0541159392f", + "sha256:59c0b02d0a6c384d453fece7566d1c7e6b7bae4fc5874ef2ef46d56776d61c9e", + "sha256:5d598b938678ebf3c67377cdd45e09d431369c3b1a5b331058c338e201f12b27", + "sha256:5df2768244d19ab7f60546d0c7c63ce1581f7af8b5de3eb3004b9b6fc8a9f84b", + "sha256:5ef34d190326c3b1f822a5b7a45f6c4535e2f47ed06fec77d3d799c450b2651e", + "sha256:6975a3fac6bc83c4a65c9f9fcab9e47019a11d3d2cf7f3c0d03431bf145a941e", + "sha256:6c9a799e985904922a4d207a94eae35c78ebae90e128f0c4e521ce339396be9d", + "sha256:70df4e3b545a17496c9b3f41f5115e69a4f2e77e94e1d2a8e1070bc0c38c8a3c", + "sha256:7473e861101c9e72452f9bf8acb984947aa1661a7704553a9f6e4baa5ba64415", + "sha256:8102eaf27e1e448db915d08afa8b41d6c7ca7a04b7d73af6514df10a3e74bd82", + "sha256:87c450779d0914f2861b8526e035c5e6da0a3199d8f1add1a665e1cbc6fc6d02", + "sha256:8b7ee99e510d7b66cdb6c593f21c043c248537a32e0bedf02e01e9553a172314", + "sha256:91fc98adde3d7881af9b59ed0294046f3806221863722ba7d8d120c575314325", + "sha256:94411f22c3985acaec6f83c6df553f2dbe17b698cc7f8ae751ff2237d96b9e3c", + "sha256:98d85c6a2bef81588d9227dde12db8a7f47f639f4a17c9ae08e773aa9c697bf3", + "sha256:9ad5db27f9cabae298d151c85cf2bad1d359a1b9c686a275df03385758e2f914", + "sha256:a0b71b1b8fbf2b96e41c4d990244165e2c9be83d54962a9a1d118fd8657d2045", + "sha256:a0f100c8912c114ff53e1202d0078b425bee3649ae34d7b070e9697f93c5d52d", + "sha256:a591fe9e525846e4d154205572a029f653ada1a78b93697f3b5a8f1f2bc055b9", + "sha256:a5c84c68147988265e60416b57fc83425a78058853509c1b0629c180094904a5", + "sha256:a66d3508133af6e8548451b25058d5812812ec3798c886bf38ed24a98216fab2", + "sha256:a8c4917bd7ad33e8eb21e9a5bbba979b49d9a97acb3a803092cbc1133e20343c", + "sha256:b3bbeb01c2b273cca1e1e0c5df57f12dce9a4dd331b4fa1635b8bec26350bde3", + "sha256:cba9d6b9a7d64d4bd46167096fc9d2f835e25d7e4c121fb2ddfc6528fb0413b2", + "sha256:cc4d65aeeaa04136a12677d3dd0b1c0c94dc43abac5860ab33cceb42b801c1e8", + "sha256:ce4bcc037df4fc5e3d184794f27bdaab018943698f4ca31630bc7f84a7b69c6d", + "sha256:cec7d9412a9102bdc577382c3929b337320c4c4c4849f2c5cdd14d7368c5562d", + "sha256:d400bfb9a37b1351253cb402671cea7e89bdecc294e8016a707f6d1d8ac934f9", + "sha256:d61f4695e6c866a23a21acab0509af1cdfd2c013cf256bbf5b6b5e2695827162", + "sha256:db0fbb9c62743ce59a9ff687eb5f4afbe77e5e8403d6697f7446e5f609976f76", + "sha256:dd86c085fae2efd48ac91dd7ccffcfc0571387fe1193d33b6394db7ef31fe2a4", + "sha256:e00b098126fd45523dd056d2efba6c5a63b71ffe9f2bbe1a4fe1716e1d0c331e", + "sha256:e229a521186c75c8ad9490854fd8bbdd9a0c9aa3a524326b55be83b54d4e0ad9", + "sha256:e263d77ee3dd201c3a142934a086a4450861778baaeeb45db4591ef65550b0a6", + "sha256:ed9cb427ba5504c1dc15ede7d516b84757c3e3d7868ccc85121d9310d27eed0b", + "sha256:fa6693661a4c91757f4412306191b6dc88c1703f780c8234035eac011922bc01", + "sha256:fcd131dd944808b5bdb38e6f5b53013c5aa4f334c5cad0c72742f6eba4b73db0" + ], + "version": "==1.15.1" + }, + "charset-normalizer": { + "hashes": [ + "sha256:5a3d016c7c547f69d6f81fb0db9449ce888b418b5b9952cc5e6e66843e9dd845", + "sha256:83e9a75d1911279afd89352c68b45348559d1fc0506b054b346651b5e7fee29f" + ], + "markers": "python_version >= '3.6'", + "version": "==2.1.1" + }, + "click": { + "hashes": [ + "sha256:7682dc8afb30297001674575ea00d1814d808d6a36af415a82bd481d37ba7b8e", + "sha256:bb4d8133cb15a609f44e8213d9b391b0809795062913b383c62be0ee95b1db48" + ], + "markers": "python_version >= '3.7'", + "version": "==8.1.3" + }, + "cssselect2": { + "hashes": [ + "sha256:1ccd984dab89fc68955043aca4e1b03e0cf29cad9880f6e28e3ba7a74b14aa5a", + "sha256:fd23a65bfd444595913f02fc71f6b286c29261e354c41d722ca7a261a49b5969" + ], + "markers": "python_version >= '3.7'", + "version": "==0.7.0" + }, + "defusedxml": { + "hashes": [ + "sha256:1bb3032db185915b62d7c6209c5a8792be6a32ab2fedacc84e01b52c51aa3e69", + "sha256:a352e7e428770286cc899e2542b6cdaedb2b4953ff269a210103ec58f6198a61" + ], + "markers": "python_version >= '2.7' and python_version not in '3.0, 3.1, 3.2, 3.3, 3.4'", + "version": "==0.7.1" + }, + "ghp-import": { + "hashes": [ + "sha256:8337dd7b50877f163d4c0289bc1f1c7f127550241988d568c1db512c4324a619", + "sha256:9c535c4c61193c2df8871222567d7fd7e5014d835f97dc7b7439069e2413d343" + ], + "version": "==2.1.0" + }, + "idna": { + "hashes": [ + "sha256:814f528e8dead7d329833b91c5faa87d60bf71824cd12a7530b5526063d02cb4", + "sha256:90b77e79eaa3eba6de819a0c442c0b4ceefc341a7a2ab77d7562bf49f425c5c2" + ], + "markers": "python_version >= '3.5'", + "version": "==3.4" + }, + "jieba": { + "hashes": [ + "sha256:055ca12f62674fafed09427f176506079bc135638a14e23e25be909131928db2" + ], + "index": "pypi", + "version": "==0.42.1" + }, + "jinja2": { + "hashes": [ + "sha256:31351a702a408a9e7595a8fc6150fc3f43bb6bf7e319770cbc0db9df9437e852", + "sha256:6088930bfe239f0e6710546ab9c19c9ef35e29792895fed6e6e31a023a182a61" + ], + "markers": "python_version >= '3.7'", + "version": "==3.1.2" + }, + "markdown": { + "hashes": [ + "sha256:cbb516f16218e643d8e0a95b309f77eb118cb138d39a4f27851e6a63581db874", + "sha256:f5da449a6e1c989a4cea2631aa8ee67caa5a2ef855d551c88f9e309f4634c621" + ], + "markers": "python_version >= '3.6'", + "version": "==3.3.7" + }, + "markupsafe": { + "hashes": [ + "sha256:0212a68688482dc52b2d45013df70d169f542b7394fc744c02a57374a4207003", + "sha256:089cf3dbf0cd6c100f02945abeb18484bd1ee57a079aefd52cffd17fba910b88", + "sha256:10c1bfff05d95783da83491be968e8fe789263689c02724e0c691933c52994f5", + "sha256:33b74d289bd2f5e527beadcaa3f401e0df0a89927c1559c8566c066fa4248ab7", + "sha256:3799351e2336dc91ea70b034983ee71cf2f9533cdff7c14c90ea126bfd95d65a", + "sha256:3ce11ee3f23f79dbd06fb3d63e2f6af7b12db1d46932fe7bd8afa259a5996603", + "sha256:421be9fbf0ffe9ffd7a378aafebbf6f4602d564d34be190fc19a193232fd12b1", + "sha256:43093fb83d8343aac0b1baa75516da6092f58f41200907ef92448ecab8825135", + "sha256:46d00d6cfecdde84d40e572d63735ef81423ad31184100411e6e3388d405e247", + "sha256:4a33dea2b688b3190ee12bd7cfa29d39c9ed176bda40bfa11099a3ce5d3a7ac6", + "sha256:4b9fe39a2ccc108a4accc2676e77da025ce383c108593d65cc909add5c3bd601", + "sha256:56442863ed2b06d19c37f94d999035e15ee982988920e12a5b4ba29b62ad1f77", + "sha256:671cd1187ed5e62818414afe79ed29da836dde67166a9fac6d435873c44fdd02", + "sha256:694deca8d702d5db21ec83983ce0bb4b26a578e71fbdbd4fdcd387daa90e4d5e", + "sha256:6a074d34ee7a5ce3effbc526b7083ec9731bb3cbf921bbe1d3005d4d2bdb3a63", + "sha256:6d0072fea50feec76a4c418096652f2c3238eaa014b2f94aeb1d56a66b41403f", + "sha256:6fbf47b5d3728c6aea2abb0589b5d30459e369baa772e0f37a0320185e87c980", + "sha256:7f91197cc9e48f989d12e4e6fbc46495c446636dfc81b9ccf50bb0ec74b91d4b", + "sha256:86b1f75c4e7c2ac2ccdaec2b9022845dbb81880ca318bb7a0a01fbf7813e3812", + "sha256:8dc1c72a69aa7e082593c4a203dcf94ddb74bb5c8a731e4e1eb68d031e8498ff", + "sha256:8e3dcf21f367459434c18e71b2a9532d96547aef8a871872a5bd69a715c15f96", + "sha256:8e576a51ad59e4bfaac456023a78f6b5e6e7651dcd383bcc3e18d06f9b55d6d1", + "sha256:96e37a3dc86e80bf81758c152fe66dbf60ed5eca3d26305edf01892257049925", + "sha256:97a68e6ada378df82bc9f16b800ab77cbf4b2fada0081794318520138c088e4a", + "sha256:99a2a507ed3ac881b975a2976d59f38c19386d128e7a9a18b7df6fff1fd4c1d6", + "sha256:a49907dd8420c5685cfa064a1335b6754b74541bbb3706c259c02ed65b644b3e", + "sha256:b09bf97215625a311f669476f44b8b318b075847b49316d3e28c08e41a7a573f", + "sha256:b7bd98b796e2b6553da7225aeb61f447f80a1ca64f41d83612e6139ca5213aa4", + "sha256:b87db4360013327109564f0e591bd2a3b318547bcef31b468a92ee504d07ae4f", + "sha256:bcb3ed405ed3222f9904899563d6fc492ff75cce56cba05e32eff40e6acbeaa3", + "sha256:d4306c36ca495956b6d568d276ac11fdd9c30a36f1b6eb928070dc5360b22e1c", + "sha256:d5ee4f386140395a2c818d149221149c54849dfcfcb9f1debfe07a8b8bd63f9a", + "sha256:dda30ba7e87fbbb7eab1ec9f58678558fd9a6b8b853530e176eabd064da81417", + "sha256:e04e26803c9c3851c931eac40c695602c6295b8d432cbe78609649ad9bd2da8a", + "sha256:e1c0b87e09fa55a220f058d1d49d3fb8df88fbfab58558f1198e08c1e1de842a", + "sha256:e72591e9ecd94d7feb70c1cbd7be7b3ebea3f548870aa91e2732960fa4d57a37", + "sha256:e8c843bbcda3a2f1e3c2ab25913c80a3c5376cd00c6e8c4a86a89a28c8dc5452", + "sha256:efc1913fd2ca4f334418481c7e595c00aad186563bbc1ec76067848c7ca0a933", + "sha256:f121a1420d4e173a5d96e47e9a0c0dcff965afdf1626d28de1460815f7c4ee7a", + "sha256:fc7b548b17d238737688817ab67deebb30e8073c95749d55538ed473130ec0c7" + ], + "markers": "python_version >= '3.7'", + "version": "==2.1.1" + }, + "mergedeep": { + "hashes": [ + "sha256:0096d52e9dad9939c3d975a774666af186eda617e6ca84df4c94dec30004f2a8", + "sha256:70775750742b25c0d8f36c55aed03d24c3384d17c951b3175d898bd778ef0307" + ], + "markers": "python_version >= '3.6'", + "version": "==1.3.4" + }, + "mkdocs": { + "hashes": [ + "sha256:8947af423a6d0facf41ea1195b8e1e8c85ad94ac95ae307fe11232e0424b11c5", + "sha256:c8856a832c1e56702577023cd64cc5f84948280c1c0fcc6af4cd39006ea6aa8c" + ], + "index": "pypi", + "version": "==1.4.2" + }, + "mkdocs-material": { + "hashes": [ + "sha256:143ea55843b3747b640e1110824d91e8a4c670352380e166e64959f9abe98862", + "sha256:45eeabb23d2caba8fa3b85c91d9ec8e8b22add716e9bba8faf16d56af8aa5622" + ], + "index": "pypi", + "version": "==8.5.9" + }, + "mkdocs-material-extensions": { + "hashes": [ + "sha256:96ca979dae66d65c2099eefe189b49d5ac62f76afb59c38e069ffc7cf3c131ec", + "sha256:bcc2e5fc70c0ec50e59703ee6e639d87c7e664c0c441c014ea84461a90f1e902" + ], + "markers": "python_version >= '3.7'", + "version": "==1.1" + }, + "packaging": { + "hashes": [ + "sha256:dd47c42927d89ab911e606518907cc2d3a1f38bbd026385970643f9c5b8ecfeb", + "sha256:ef103e05f519cdc783ae24ea4e2e0f508a9c99b2d4969652eed6a2e1ea5bd522" + ], + "markers": "python_version >= '3.6'", + "version": "==21.3" + }, + "pillow": { + "hashes": [ + "sha256:03150abd92771742d4a8cd6f2fa6246d847dcd2e332a18d0c15cc75bf6703040", + "sha256:073adb2ae23431d3b9bcbcff3fe698b62ed47211d0716b067385538a1b0f28b8", + "sha256:0b07fffc13f474264c336298d1b4ce01d9c5a011415b79d4ee5527bb69ae6f65", + "sha256:0b7257127d646ff8676ec8a15520013a698d1fdc48bc2a79ba4e53df792526f2", + "sha256:12ce4932caf2ddf3e41d17fc9c02d67126935a44b86df6a206cf0d7161548627", + "sha256:15c42fb9dea42465dfd902fb0ecf584b8848ceb28b41ee2b58f866411be33f07", + "sha256:18498994b29e1cf86d505edcb7edbe814d133d2232d256db8c7a8ceb34d18cef", + "sha256:1c7c8ae3864846fc95f4611c78129301e203aaa2af813b703c55d10cc1628535", + "sha256:22b012ea2d065fd163ca096f4e37e47cd8b59cf4b0fd47bfca6abb93df70b34c", + "sha256:276a5ca930c913f714e372b2591a22c4bd3b81a418c0f6635ba832daec1cbcfc", + "sha256:2e0918e03aa0c72ea56edbb00d4d664294815aa11291a11504a377ea018330d3", + "sha256:3033fbe1feb1b59394615a1cafaee85e49d01b51d54de0cbf6aa8e64182518a1", + "sha256:3168434d303babf495d4ba58fc22d6604f6e2afb97adc6a423e917dab828939c", + "sha256:32a44128c4bdca7f31de5be641187367fe2a450ad83b833ef78910397db491aa", + "sha256:3dd6caf940756101205dffc5367babf288a30043d35f80936f9bfb37f8355b32", + "sha256:40e1ce476a7804b0fb74bcfa80b0a2206ea6a882938eaba917f7a0f004b42502", + "sha256:41e0051336807468be450d52b8edd12ac60bebaa97fe10c8b660f116e50b30e4", + "sha256:4390e9ce199fc1951fcfa65795f239a8a4944117b5935a9317fb320e7767b40f", + "sha256:502526a2cbfa431d9fc2a079bdd9061a2397b842bb6bc4239bb176da00993812", + "sha256:51e0e543a33ed92db9f5ef69a0356e0b1a7a6b6a71b80df99f1d181ae5875636", + "sha256:57751894f6618fd4308ed8e0c36c333e2f5469744c34729a27532b3db106ee20", + "sha256:5d77adcd56a42d00cc1be30843d3426aa4e660cab4a61021dc84467123f7a00c", + "sha256:655a83b0058ba47c7c52e4e2df5ecf484c1b0b0349805896dd350cbc416bdd91", + "sha256:68943d632f1f9e3dce98908e873b3a090f6cba1cbb1b892a9e8d97c938871fbe", + "sha256:6c738585d7a9961d8c2821a1eb3dcb978d14e238be3d70f0a706f7fa9316946b", + "sha256:73bd195e43f3fadecfc50c682f5055ec32ee2c933243cafbfdec69ab1aa87cad", + "sha256:772a91fc0e03eaf922c63badeca75e91baa80fe2f5f87bdaed4280662aad25c9", + "sha256:77ec3e7be99629898c9a6d24a09de089fa5356ee408cdffffe62d67bb75fdd72", + "sha256:7db8b751ad307d7cf238f02101e8e36a128a6cb199326e867d1398067381bff4", + "sha256:801ec82e4188e935c7f5e22e006d01611d6b41661bba9fe45b60e7ac1a8f84de", + "sha256:82409ffe29d70fd733ff3c1025a602abb3e67405d41b9403b00b01debc4c9a29", + "sha256:828989c45c245518065a110434246c44a56a8b2b2f6347d1409c787e6e4651ee", + "sha256:829f97c8e258593b9daa80638aee3789b7df9da5cf1336035016d76f03b8860c", + "sha256:871b72c3643e516db4ecf20efe735deb27fe30ca17800e661d769faab45a18d7", + "sha256:89dca0ce00a2b49024df6325925555d406b14aa3efc2f752dbb5940c52c56b11", + "sha256:90fb88843d3902fe7c9586d439d1e8c05258f41da473952aa8b328d8b907498c", + "sha256:97aabc5c50312afa5e0a2b07c17d4ac5e865b250986f8afe2b02d772567a380c", + "sha256:9aaa107275d8527e9d6e7670b64aabaaa36e5b6bd71a1015ddd21da0d4e06448", + "sha256:9f47eabcd2ded7698106b05c2c338672d16a6f2a485e74481f524e2a23c2794b", + "sha256:a0a06a052c5f37b4ed81c613a455a81f9a3a69429b4fd7bb913c3fa98abefc20", + "sha256:ab388aaa3f6ce52ac1cb8e122c4bd46657c15905904b3120a6248b5b8b0bc228", + "sha256:ad58d27a5b0262c0c19b47d54c5802db9b34d38bbf886665b626aff83c74bacd", + "sha256:ae5331c23ce118c53b172fa64a4c037eb83c9165aba3a7ba9ddd3ec9fa64a699", + "sha256:af0372acb5d3598f36ec0914deed2a63f6bcdb7b606da04dc19a88d31bf0c05b", + "sha256:afa4107d1b306cdf8953edde0534562607fe8811b6c4d9a486298ad31de733b2", + "sha256:b03ae6f1a1878233ac620c98f3459f79fd77c7e3c2b20d460284e1fb370557d4", + "sha256:b0915e734b33a474d76c28e07292f196cdf2a590a0d25bcc06e64e545f2d146c", + "sha256:b4012d06c846dc2b80651b120e2cdd787b013deb39c09f407727ba90015c684f", + "sha256:b472b5ea442148d1c3e2209f20f1e0bb0eb556538690fa70b5e1f79fa0ba8dc2", + "sha256:b59430236b8e58840a0dfb4099a0e8717ffb779c952426a69ae435ca1f57210c", + "sha256:b90f7616ea170e92820775ed47e136208e04c967271c9ef615b6fbd08d9af0e3", + "sha256:b9a65733d103311331875c1dca05cb4606997fd33d6acfed695b1232ba1df193", + "sha256:bac18ab8d2d1e6b4ce25e3424f709aceef668347db8637c2296bcf41acb7cf48", + "sha256:bca31dd6014cb8b0b2db1e46081b0ca7d936f856da3b39744aef499db5d84d02", + "sha256:be55f8457cd1eac957af0c3f5ece7bc3f033f89b114ef30f710882717670b2a8", + "sha256:c7025dce65566eb6e89f56c9509d4f628fddcedb131d9465cacd3d8bac337e7e", + "sha256:c935a22a557a560108d780f9a0fc426dd7459940dc54faa49d83249c8d3e760f", + "sha256:dbb8e7f2abee51cef77673be97760abff1674ed32847ce04b4af90f610144c7b", + "sha256:e6ea6b856a74d560d9326c0f5895ef8050126acfdc7ca08ad703eb0081e82b74", + "sha256:ebf2029c1f464c59b8bdbe5143c79fa2045a581ac53679733d3a91d400ff9efb", + "sha256:f1ff2ee69f10f13a9596480335f406dd1f70c3650349e2be67ca3139280cade0" + ], + "index": "pypi", + "version": "==9.3.0" + }, + "pycparser": { + "hashes": [ + "sha256:8ee45429555515e1f6b185e78100aea234072576aa43ab53aefcae078162fca9", + "sha256:e644fdec12f7872f86c58ff790da456218b10f863970249516d60a5eaca77206" + ], + "version": "==2.21" + }, + "pygments": { + "hashes": [ + "sha256:56a8508ae95f98e2b9bdf93a6be5ae3f7d8af858b43e02c5a2ff083726be40c1", + "sha256:f643f331ab57ba3c9d89212ee4a2dabc6e94f117cf4eefde99a0574720d14c42" + ], + "markers": "python_version >= '3.6'", + "version": "==2.13.0" + }, + "pymdown-extensions": { + "hashes": [ + "sha256:1bd4a173095ef8c433b831af1f3cb13c10883be0c100ae613560668e594651f7", + "sha256:8e62688a8b1128acd42fa823f3d429d22f4284b5e6dd4d3cd56721559a5a211b" + ], + "markers": "python_version >= '3.7'", + "version": "==9.8" + }, + "pyparsing": { + "hashes": [ + "sha256:2b020ecf7d21b687f219b71ecad3631f644a47f01403fa1d1036b0c6416d70fb", + "sha256:5026bae9a10eeaefb61dab2f09052b9f4307d44aee4eda64b309723d8d206bbc" + ], + "markers": "python_full_version >= '3.6.8'", + "version": "==3.0.9" + }, + "python-dateutil": { + "hashes": [ + "sha256:0123cacc1627ae19ddf3c27a5de5bd67ee4586fbdd6440d9748f8abb483d3e86", + "sha256:961d03dc3453ebbc59dbdea9e4e11c5651520a876d0f4db161e8674aae935da9" + ], + "markers": "python_version >= '2.7' and python_version not in '3.0, 3.1, 3.2, 3.3'", + "version": "==2.8.2" + }, + "pyyaml": { + "hashes": [ + "sha256:01b45c0191e6d66c470b6cf1b9531a771a83c1c4208272ead47a3ae4f2f603bf", + "sha256:0283c35a6a9fbf047493e3a0ce8d79ef5030852c51e9d911a27badfde0605293", + "sha256:055d937d65826939cb044fc8c9b08889e8c743fdc6a32b33e2390f66013e449b", + "sha256:07751360502caac1c067a8132d150cf3d61339af5691fe9e87803040dbc5db57", + "sha256:0b4624f379dab24d3725ffde76559cff63d9ec94e1736b556dacdfebe5ab6d4b", + "sha256:0ce82d761c532fe4ec3f87fc45688bdd3a4c1dc5e0b4a19814b9009a29baefd4", + "sha256:1e4747bc279b4f613a09eb64bba2ba602d8a6664c6ce6396a4d0cd413a50ce07", + "sha256:213c60cd50106436cc818accf5baa1aba61c0189ff610f64f4a3e8c6726218ba", + "sha256:231710d57adfd809ef5d34183b8ed1eeae3f76459c18fb4a0b373ad56bedcdd9", + "sha256:277a0ef2981ca40581a47093e9e2d13b3f1fbbeffae064c1d21bfceba2030287", + "sha256:2cd5df3de48857ed0544b34e2d40e9fac445930039f3cfe4bcc592a1f836d513", + "sha256:40527857252b61eacd1d9af500c3337ba8deb8fc298940291486c465c8b46ec0", + "sha256:432557aa2c09802be39460360ddffd48156e30721f5e8d917f01d31694216782", + "sha256:473f9edb243cb1935ab5a084eb238d842fb8f404ed2193a915d1784b5a6b5fc0", + "sha256:48c346915c114f5fdb3ead70312bd042a953a8ce5c7106d5bfb1a5254e47da92", + "sha256:50602afada6d6cbfad699b0c7bb50d5ccffa7e46a3d738092afddc1f9758427f", + "sha256:68fb519c14306fec9720a2a5b45bc9f0c8d1b9c72adf45c37baedfcd949c35a2", + "sha256:77f396e6ef4c73fdc33a9157446466f1cff553d979bd00ecb64385760c6babdc", + "sha256:81957921f441d50af23654aa6c5e5eaf9b06aba7f0a19c18a538dc7ef291c5a1", + "sha256:819b3830a1543db06c4d4b865e70ded25be52a2e0631ccd2f6a47a2822f2fd7c", + "sha256:897b80890765f037df3403d22bab41627ca8811ae55e9a722fd0392850ec4d86", + "sha256:98c4d36e99714e55cfbaaee6dd5badbc9a1ec339ebfc3b1f52e293aee6bb71a4", + "sha256:9df7ed3b3d2e0ecfe09e14741b857df43adb5a3ddadc919a2d94fbdf78fea53c", + "sha256:9fa600030013c4de8165339db93d182b9431076eb98eb40ee068700c9c813e34", + "sha256:a80a78046a72361de73f8f395f1f1e49f956c6be882eed58505a15f3e430962b", + "sha256:afa17f5bc4d1b10afd4466fd3a44dc0e245382deca5b3c353d8b757f9e3ecb8d", + "sha256:b3d267842bf12586ba6c734f89d1f5b871df0273157918b0ccefa29deb05c21c", + "sha256:b5b9eccad747aabaaffbc6064800670f0c297e52c12754eb1d976c57e4f74dcb", + "sha256:bfaef573a63ba8923503d27530362590ff4f576c626d86a9fed95822a8255fd7", + "sha256:c5687b8d43cf58545ade1fe3e055f70eac7a5a1a0bf42824308d868289a95737", + "sha256:cba8c411ef271aa037d7357a2bc8f9ee8b58b9965831d9e51baf703280dc73d3", + "sha256:d15a181d1ecd0d4270dc32edb46f7cb7733c7c508857278d3d378d14d606db2d", + "sha256:d4b0ba9512519522b118090257be113b9468d804b19d63c71dbcf4a48fa32358", + "sha256:d4db7c7aef085872ef65a8fd7d6d09a14ae91f691dec3e87ee5ee0539d516f53", + "sha256:d4eccecf9adf6fbcc6861a38015c2a64f38b9d94838ac1810a9023a0609e1b78", + "sha256:d67d839ede4ed1b28a4e8909735fc992a923cdb84e618544973d7dfc71540803", + "sha256:daf496c58a8c52083df09b80c860005194014c3698698d1a57cbcfa182142a3a", + "sha256:dbad0e9d368bb989f4515da330b88a057617d16b6a8245084f1b05400f24609f", + "sha256:e61ceaab6f49fb8bdfaa0f92c4b57bcfbea54c09277b1b4f7ac376bfb7a7c174", + "sha256:f84fbc98b019fef2ee9a1cb3ce93e3187a6df0b2538a651bfb890254ba9f90b5" + ], + "markers": "python_version >= '3.6'", + "version": "==6.0" + }, + "pyyaml-env-tag": { + "hashes": [ + "sha256:70092675bda14fdec33b31ba77e7543de9ddc88f2e5b99160396572d11525bdb", + "sha256:af31106dec8a4d68c60207c1886031cbf839b68aa7abccdb19868200532c2069" + ], + "markers": "python_version >= '3.6'", + "version": "==0.1" + }, + "requests": { + "hashes": [ + "sha256:7c5599b102feddaa661c826c56ab4fee28bfd17f5abca1ebbe3e7f19d7c97983", + "sha256:8fefa2a1a1365bf5520aac41836fbee479da67864514bdb821f31ce07ce65349" + ], + "markers": "python_version >= '3.7' and python_version < '4'", + "version": "==2.28.1" + }, + "six": { + "hashes": [ + "sha256:1e61c37477a1626458e36f7b1d82aa5c9b094fa4802892072e49de9c60c4c926", + "sha256:8abb2f1d86890a2dfb989f9a77cfcfd3e47c2a354b01111771326f8aa26e0254" + ], + "markers": "python_version >= '2.7' and python_version not in '3.0, 3.1, 3.2, 3.3'", + "version": "==1.16.0" + }, + "tinycss2": { + "hashes": [ + "sha256:2b80a96d41e7c3914b8cda8bc7f705a4d9c49275616e886103dd839dfc847847", + "sha256:8cff3a8f066c2ec677c06dbc7b45619804a6938478d9d73c284b29d14ecb0627" + ], + "markers": "python_version >= '3.7'", + "version": "==1.2.1" + }, + "urllib3": { + "hashes": [ + "sha256:3fa96cf423e6987997fc326ae8df396db2a8b7c667747d47ddd8ecba91f4a74e", + "sha256:b930dd878d5a8afb066a637fbb35144fe7901e3b209d1cd4f524bd0e9deee997" + ], + "markers": "python_version >= '2.7' and python_version not in '3.0, 3.1, 3.2, 3.3, 3.4, 3.5' and python_version < '4'", + "version": "==1.26.12" + }, + "watchdog": { + "hashes": [ + "sha256:083171652584e1b8829581f965b9b7723ca5f9a2cd7e20271edf264cfd7c1412", + "sha256:117ffc6ec261639a0209a3252546b12800670d4bf5f84fbd355957a0595fe654", + "sha256:186f6c55abc5e03872ae14c2f294a153ec7292f807af99f57611acc8caa75306", + "sha256:195fc70c6e41237362ba720e9aaf394f8178bfc7fa68207f112d108edef1af33", + "sha256:226b3c6c468ce72051a4c15a4cc2ef317c32590d82ba0b330403cafd98a62cfd", + "sha256:247dcf1df956daa24828bfea5a138d0e7a7c98b1a47cf1fa5b0c3c16241fcbb7", + "sha256:255bb5758f7e89b1a13c05a5bceccec2219f8995a3a4c4d6968fe1de6a3b2892", + "sha256:43ce20ebb36a51f21fa376f76d1d4692452b2527ccd601950d69ed36b9e21609", + "sha256:4f4e1c4aa54fb86316a62a87b3378c025e228178d55481d30d857c6c438897d6", + "sha256:5952135968519e2447a01875a6f5fc8c03190b24d14ee52b0f4b1682259520b1", + "sha256:64a27aed691408a6abd83394b38503e8176f69031ca25d64131d8d640a307591", + "sha256:6b17d302850c8d412784d9246cfe8d7e3af6bcd45f958abb2d08a6f8bedf695d", + "sha256:70af927aa1613ded6a68089a9262a009fbdf819f46d09c1a908d4b36e1ba2b2d", + "sha256:7a833211f49143c3d336729b0020ffd1274078e94b0ae42e22f596999f50279c", + "sha256:8250546a98388cbc00c3ee3cc5cf96799b5a595270dfcfa855491a64b86ef8c3", + "sha256:97f9752208f5154e9e7b76acc8c4f5a58801b338de2af14e7e181ee3b28a5d39", + "sha256:9f05a5f7c12452f6a27203f76779ae3f46fa30f1dd833037ea8cbc2887c60213", + "sha256:a735a990a1095f75ca4f36ea2ef2752c99e6ee997c46b0de507ba40a09bf7330", + "sha256:ad576a565260d8f99d97f2e64b0f97a48228317095908568a9d5c786c829d428", + "sha256:b530ae007a5f5d50b7fbba96634c7ee21abec70dc3e7f0233339c81943848dc1", + "sha256:bfc4d351e6348d6ec51df007432e6fe80adb53fd41183716017026af03427846", + "sha256:d3dda00aca282b26194bdd0adec21e4c21e916956d972369359ba63ade616153", + "sha256:d9820fe47c20c13e3c9dd544d3706a2a26c02b2b43c993b62fcd8011bcc0adb3", + "sha256:ed80a1628cee19f5cfc6bb74e173f1b4189eb532e705e2a13e3250312a62e0c9", + "sha256:ee3e38a6cc050a8830089f79cbec8a3878ec2fe5160cdb2dc8ccb6def8552658" + ], + "markers": "python_version >= '3.6'", + "version": "==2.1.9" + }, + "webencodings": { + "hashes": [ + "sha256:a0af1213f3c2226497a97e2b3aa01a7e4bee4f403f95be16fc9acd2947514a78", + "sha256:b36a1c245f2d304965eb4e0a82848379241dc04b865afcc4aab16748587e1923" + ], + "version": "==0.5.1" + } + }, + "develop": {} +} diff --git a/docs/advanced.md b/docs/advanced.md new file mode 100644 index 0000000..2d2975e --- /dev/null +++ b/docs/advanced.md @@ -0,0 +1,95 @@ +--- +comments: true +title: 进阶问题 +--- + +可能接下来我不会解释一些词语了，要是看不懂一些一些「术语」，不要紧，全都是因为我懒……你也可以在评论区或直接回复为询问相关问题。 + +### 按需沟通 + +那么如果理解上述的「小区」比喻，那么： + +为什么我所处的站点看不到一个讨论的全部回复？ + +为什么我看到的点赞数和转嘟数在不同站点之间不同？ + +…… + +这些问题都的原因是因为各个小区（站点）的沟通有需要才会进行沟通，比如只有 A 小区的甲订阅了 B 小区的乙，两个服务器之间才会进行沟通。B 小区也只会拉取本小区订阅人的回复（回复也是一封信件、消息），如果有 C 小区的人参与了讨论而 B 小区没有任何人订阅 C 小区参与讨论的这个人，那么就「概率」不会抓取。 + +造成这个现象的**根本原因**就是运维小区（站点）的站长所采用的服务器性能大概率还没你手机来得更好，比如我现在使用的是就是一个 2 核 2G 内存的服务器，可想而知这么弱小的机子肯定撑不下整个联邦宇宙的所有信息，所以**不得不**采取「按需沟通」的方式。 + +### Q：我的主页为什么出现了回复？是不是意味着我的回复也有可能被看到？ + +如果你同时关注了 A 和 B，那么 A 和 B 的讨论就会自动推送到你的主页上（觉得有需要），如果你只关注了其中一方，那么这个回复就不会推送到主页上。 + +如果你觉得不需要这个功能，可以选择在主页的菜单选择不看回复（同时还可以不看转嘟）。 + +![17](./img/17.png) + +**Q：那么这样就可以安心了吗……？** + +联邦宇宙中也有其它应用程序，他们采取的策略各不相同，所以应当默认回复会被人看到，所以有什么不想被人看到的回复，请善用**嘟文可见性**功能（仅关注可见或是私信）。 + +### Q：为什么我不能搜索或搜不到东西？ + +因为 `mastdon` 全文搜索是依赖于 `Elasticsearch` 这个用 `java` 编写的软件，是一个内存杀手，所以一些使用低性能机器的站点会不安装全文搜索功能， + +即使安装了 `Elasticsearch` ，其默认用的分词逻辑也不适合中文，会拆成一个字一个字搜索，例如 `新华字典` 分词搜索应该是 `新华` 和`字典` ，但默认逻辑是 `新`、`华`、`字`、`典`。 + +🛠️而即使站点管理员优化了分词，`mastodon` 的默认逻辑是只搜索**与自己有关**的嘟文（点赞、回复、转发、收藏），此举是为了防止使用搜索功能带来的潜在网暴行为。 + +### Q：搜索框「或输入链接」是什么意思？ + +`mastodon` 同时也是一个网站，每条嘟文都有对应的 `URL`，帖文可见性为**公开和未列出**的帖子可以直接通过浏览器访问（常见的联邦应用也是类似，当然不排除有些联邦站点限制了通过网页形式访问到相关帖文）。 + +`mastodon` 也将原始帖文的链接列了出来，就是右上角的时间那栏，可以很方便使用右键（移动端为长按）选择新建标签页打开（或 `CTRL` + 左键），**V4.0.2+** 将原始页面打开整合进了下拉菜单的一个选项中，来前去原始站点浏览帖文，如果你所在的站点人数和订阅人数少，那么大概率会抓取不完一条嘟文下的全部回复，可通过这方式去补强。 + +![18](./img/18.png) + +![19](./img/19.png) + +同时，如果你所在的站点没有人订阅导致接收不到某条帖子，但是又知道这帖子的链接，就可以将这条链接粘贴到搜索框并确认，即可让服务器强制抓取这条帖子。 + +同时也支持帐号页的 `URL`，这既是「或输入链接」的意思。 + +### Q：「锁嘟」和「隐藏社交网络」是什么意思？ + +**锁嘟：**别人的关注必须通过你的同意才能建立起被关注联系（也可以选择拒绝关注请求），同时会将新发表嘟文的「嘟文可见性」默认设置成「未公开」（这可以另行再次设置）。 + +*同时，即使你没有启用选项，根据站点设置（可能是站点级别隐藏了某帐号），也有一些关注请求会要你手动批准 + +**隐藏社交网络:**开启后别人将不能查看你的关注和被关注有什么帐号，简单有效。 + +*但同时也请考虑到联邦之间一些来自小站的人可能没有太大能力找到感兴趣的帐号，要是你愿意为这些人提供帮助，或是想推荐自己的关注的帐号，也可以不启用这选项。 + +### Q：我在选项中开启了「搜索引擎不建立索引」，但是为什么搜索引擎还是能搜索到我的消息？ + +那是因为你本站选择了不建立索引，但是外站未必有声明让搜索引擎不爬取，而你参与的讨论又处在外站的「上下文」里……所以也一并抓取了。 + +所以如果真的不想搜索引擎抓取，那么请将嘟文可见性定为「仅关注可见或「私信」。 + +### Q：嘟文可见性设置为公开到底是公开到一个什么程度？会有什么后果吗？ + +1. 被其他站的缓存且有可能一直存档因为无法响应自己的删除请求。 + +2. 被搜索引擎收录（即使自站选项勾选搜索引擎爬虫不爬取也有可能爬虫爬取了其他站的上下文嘟串然后顺带爬取了）即上文的提到的。 + +3. 收录到其他站的推荐里，其他站的用户可能在探索栏直接就能看到（如果在设置中的个人资料打开了「在本站用户目录中收录此账号」） + + 🦊[原嘟](https://foxsay.southfox.me/@SouthFox/108848712198804792) + +### Q:我喜欢 Rss，Mastodon 有相应支持吗？ + +有，可以通过在用户链接的后面加上 `.rss` ，既是 `rss` 页面了。 + +例如： + +``` +# 假设有一个叫 @apple@abc.me 的用户 +https://abc.me/@apple +# 则 ta 的 rss 页面为 +https://abc.me/@apple.rss +``` + +注意这只会获取嘟文可见性为「公开」的嘟文，同时不包含回复。 \ No newline at end of file diff --git a/docs/base.md b/docs/base.md new file mode 100644 index 0000000..a3b3b09 --- /dev/null +++ b/docs/base.md @@ -0,0 +1,111 @@ +--- +comments: true +title: 基础使用 +--- + +知道了一些设定，再来说说其它地方吧， + +因为 `mastodon` 是一个自由开源的程序，任何人都可以自由地修改它的代码，所以一些参数会根据站点管理员是否修改了代码而有所不同，我会用 🛠️ 进行表示，而用🦊则表示「狐说站」所修改的功能。 + +## 个人资料 + +点击「修改个人资料」按钮或是点击「首选项」→「个人资料」即可进入个人资料页，在其中可以更改自己的昵称、头像和横幅图片。 + +下方的「保护你的帐户（锁嘟）」、「隐藏你的社交网络」在后面详细叙述。 + +而下方的四个表格可以用来简要的描述自己或是放其它网站的链接。 + +最下方的「迁移」、「删除帐号」也是下叙。 + +**注意：**推荐新用户注册之后的第一件事是更改头像和昵称，这样才能让其他人觉得你不是一个机器人帐号导致拒绝、移除关注关系。 + +**再请注意：**同时因为站点之间的互通性，外站更改头像的动作**可能不会即时同步**到本服务器上，如果发现受到了一个无头像帐号的关注，可以去原站点查看有无设置头像。 + +## 如何发帖 + +`mastodon` 将一条博文、帖子称为「嘟文」，或许你会见到有些地方见到「发嘟」、「嘟文」的说法。 + +![05](./img/05.png) + +在网页端的左上方就是一个发帖区域了，简单来说在输入框写写，点击发布就成功进行了一次发言，。 + +不简单的话，右上角的「哭笑」 emoji 是选择表情，在发言框下方的按钮从左到右依次为，媒体附件、投票、嘟文可见度、内容警告、语言选择，🛠️最右的 500 为字数限制。 + +接下来依次介绍。 + +### 自定义表情 + +表情除了 `emoji` 以外，🛠️ 还会根据「站点管理员」喜好去添加的，所以尽情去使用狐狸、猫、兔子或者烂梗之类的稀奇古怪的表情吧！ + + ![06](./img/06.png) + +同时也要注意 `mastodon` 选择了表情之后会以 ` :xxxx: ` 的字符表现出来，不要将 `:` 前后的空格**删除**，否则发出来时将不会正常显示。 + +### 媒体附件 + +点击**回形针**一样的按钮即可添加媒体附件，常见的图片和音频格式都可以进行上传。 + +上传之后有一个编辑按钮，在其中可以移动显示焦点来获取更好的显示效果，还能给图片等媒体添加描述，此举可以方便一些视障人士识别图片（非强制）。 + +下方的「标记媒体为敏感内容」点击之后就会标记为敏感内容，必须要手动点击一次才会显示，通常来说被用于色情、暴力等工作场所不宜（**N**ot **S**afe **F**or **W**ork，**NSFW**） 内容，大部分站点都要求 NSFW 内容应设为「敏感内容」。 + +🛠️最多可以上传四张图片，如果站点支持上传 4+ 张图片，那么也要想着在其它 `mastodon` 站点也只会显示前四张。 + +### 投票 + +![07](./img/07.png) + +🛠️投票按钮最多支持四个选项 + +同时点击前面的圆圈将其点选为方框就是多选投票，下方分别可以再添加一个选项和设置投票的截止时间。 + +### 嘟文可见度 + +![08](./img/08.png) + +再次引入「小区」比喻，消息在不同「小区」传递时： + +选择为「公开」的嘟文，就好比「明信片」一样，大家都能看到上面显示的内容。 + +选择为「不公开」的嘟文，「不公开」这个翻译有点误导，其原文如果直接翻译应该是「不列出」，就好比装在了一个没封住的信封里，不会出现在「本站轴」、「跨站轴」和「探索」栏里，但是如果有人有心，还是能够查看的。 + +选择为「仅关注者」的嘟文，就是字面意思，像封好了信封的信一样，只有关注了你的人才能看到。 + +选择为「仅提到的人」的嘟文，就像封好了信封还要封蜡的信一样，只有被提及的用户才能看到。 + +### 内容警告 + +content warning, CW 也被称为「折叠」、「叠」，点击后输入框上方会出现预警消息输入框，下方是要写下的内容。 + +这个功能可以用来写下剧透内容、一些会让人感到不适的讨论、或者情绪过于激烈的内容，设置了 CW 的嘟文媒体附件也会强制被设为「敏感内容」。 + +### 语言选单 + +通常来讲会跟浏览器所显示的语言一致（显示为 ZH），这个选项在 `v4.0.0` 版本比较重要，因为翻译功能和语言过滤功能都会根据这选项而决定。 + +我对于这个功能的[讨论](https://foxsay.southfox.me/@SouthFox/109133835157973839)。 + +## 嘟文功能 + +![09](./img/09.png) + +新来者最容易弄混的就是不知道回复在哪里了， + +如图，在➊处，不要和其它平台的转发弄混哦。 + +➋即是转嘟，`mastodon` 的转发时相当于新浪微博的「快转」，不能在原嘟附上评论，按下时**对方会收到通知** + +➌喜欢按钮，即相当于「点赞」、「红心」按钮，按下时**对方会收到通知**。 + +❹添加到书签，按下时**对方不会收到通知**，可以自由使用这个功能去收集一些有用处的嘟文吧，如果**对方删除嘟文那么书签栏内的嘟文也有可能被删除**。 + +➎即是置顶自己的嘟文，在自己的页面上顶栏显示，最多大概五条的样子。 + +❻禁用提醒，用处在于如果你发送了一条很火的嘟文，被大家狂赞和狂转，那么可以用此功能不接收提醒，也能用来结束一场感到疲惫的争论。 + +➐🛠️编辑功能，` v4.0.0+` 版本会默认启用，`v3.5.0+` 版本可能根据「站点管理员」改动与否启用，此功能在低版本下将会看不到编辑改动，如果使用编辑功能添加图片那么其它站点**大概率会裂图**。 + +➑删除，删除此嘟，要注意删除请求**有可能不会被其它站点响应**。 + +❾删除并重新编辑，点击后会删除原嘟同时将内容复制到发嘟框上。 + diff --git a/docs/content.md b/docs/content.md new file mode 100644 index 0000000..1b0f316 --- /dev/null +++ b/docs/content.md @@ -0,0 +1,44 @@ +--- +comments: true +title: 内容管理 +--- + +## 内容管理 + +### 过滤 + +突然之间，大家都在讨论你不喜欢的话题，例如「苦粽子」，到处都是，本站、跨站、主页……有没有办法不看这种内容呢？`mastodon` 有过滤功能应付这种情况。 + +在「首选项」→「过滤器」→「添加新过滤器」 + +![13](./img/13.png) + +**标题：**过滤的简短描述，例如「压力内容」、「不安内容」等。 + +**失效时间**：过滤的失效时间，可以指定此过滤在某段时间后失效，默认永久。 + +**环境：**字面意思，可以指定过滤器在哪里生效。 + +**过滤动作：** `v4.0.0+` 版本功能，显示警告消息会过滤后显示过滤器的标题，如果战胜不了自己的「好奇心」的话可以设置成「完全隐藏」。 + +### 列表 + +> 是否还在因为关注帐号过多导致主页内容杂乱的情况感到苦恼？ + +> 可以试试 Mastodon 的列表功能，使用此功能可以将具有相同性质的帐号整理在一起，例如「爱发猫的」、「爱发吃的」、「整天嘟嘟囔囔只会发些 Emacs 和建站奇怪东西的」。 + +> 这样在使用「完全按照时间顺序排序消息」的 Mastodon 时也能更不容易错过嘟文。 +> 同时使用列表也有个隐藏好处，Mastodon 官方每人主页（和列表？）只有 400 的容量上限(v4.1.0+ 增加到了 800)，一但超过这限制数量的嘟文就再也加载不出来了。 +> 如果你订阅了几百个活跃帐号的话，那么主页可能只会存储几小时内的消息……使用列表功能可以有效缓解这个状况。 + +![15](./img/15.png) + +![16](./img/16.png) + +🦊[原嘟](https://foxsay.southfox.me/@SouthFox/108776349572523749)，同时说到了： + +> 以及本站魔改的功能是 Exclusive 列表功能（我称之为差集列表功能），这个功能可以让此列表的帐号消息不显示在主页轴上。 +> 非常适合拿来放版聊这种无法预测其内容或者一些经常发压力内容的帐号。 +> 这样在使用本站时，心情好时或有准备可以点看，心情不好时里面的内容也不会「窜访」主页上。 + +> PS：这个功能同时也修改了后端，所以将差集列表开启时使用第三方客户端也会生效。 \ No newline at end of file diff --git a/docs/fedi.md b/docs/fedi.md new file mode 100644 index 0000000..64b0715 --- /dev/null +++ b/docs/fedi.md @@ -0,0 +1,30 @@ +--- +comments: true +title: 认识联邦宇宙 +--- + +## 什么是联邦宇宙？ + +谈到这个，那么有没有想过，为什么手机由不同的公司去运营，但是还是能互相呼叫甚至跨国、跨大洋（例如联通号码呼叫电信）？电子邮件呢（QQ 邮件发送给网易邮箱）？ + +那是因为电话邮箱使用的「协议」是一样的，因为「协议」相同，所以各个不同站点之间可以相互沟通，这也称为「联邦制」。 + +但是为什么到了近代，就互相割裂了呢？QQ 空间里的内容为什么在新浪微博不能看到？在哔哩哔哩里为什么不能在爱奇艺下的某个视频评论？为什么互联网越发展反而没有一开始所诞生的电子邮件来得开放？ + +### 破局 + +虽然在数十年间有一些协议努力想去打破这种现象，但是都没翻起太大浪花，直到了 `ActivePub` 协议的发布，`ActivePub` 是由 `W3C` 起草的，`W3C` 是一个来头十分大的组织，它所起草的标准 `HTTP`、`SVG`、`CSS` 标准基本是互联网的基石。有了这样的联盟带头，那自然是一呼百应，支持这个标准的程序开始不断涌现。 + +### ActivePub + +如果某个应用支持 `ActivePub` ，那么就能和同样支持 `ActivePub` 的应用程序互相沟通，畅想一下…… `mastodon` 做为一个微博客平台: + +可以直接在某个视频网站下评论区留言了, + +可以关注某个发文站点的帐号，更新时就能立马在主页上看到， + +在某个论坛中参与直接回复某个帖子，参与讨论， + +…… + +如果将某个运行了 `ActivePub` 的站点称为一个星球的话，那么这些所有星球构成的就叫作……联邦宇宙（英语称作 Fediverse，由 Federation 联邦和 Universe 宇宙两词构成，也有很多人简写为 Fedi ）。 \ No newline at end of file diff --git a/docs/img/01.png b/docs/img/01.png new file mode 100644 index 0000000..feb1fa2 --- /dev/null +++ b/docs/img/01.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:d98efe75c07d99de6737db0f39ef768caa3f1c2fe9f256f0d636fee769e9d3c4 +size 14108 diff --git a/docs/img/02.png b/docs/img/02.png new file mode 100644 index 0000000..22ba8cc --- /dev/null +++ b/docs/img/02.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:d235b2affff209c739c9e097aaccd21fec159266b259f5c7e3f33dc6916320c0 +size 13085 diff --git a/docs/img/03.png b/docs/img/03.png new file mode 100644 index 0000000..28ec9a2 --- /dev/null +++ b/docs/img/03.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:7c1af45a0ea4387b8ea02bd0980f84e1ddfd65e73b9ac4381c74e6ffb1b99791 +size 14200 diff --git a/docs/img/04.png b/docs/img/04.png new file mode 100644 index 0000000..795b6df --- /dev/null +++ b/docs/img/04.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:90c417bc27da27a95affccc3bf042cf5c2101261b3c4ada6bb423f89b76a8927 +size 14257 diff --git a/docs/img/05.png b/docs/img/05.png new file mode 100644 index 0000000..b5f9599 --- /dev/null +++ b/docs/img/05.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:2ad3a38971e0dcf5d33d2dcc1cb4f9a7a3b7002bb11557d6f6777fea13606908 +size 7309 diff --git a/docs/img/06.png b/docs/img/06.png new file mode 100644 index 0000000..abc4c79 --- /dev/null +++ b/docs/img/06.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:e0500091b7df86f40cc2b6e55f75f30a7ddd6d666ecd4059149989d41ec2947d +size 7924 diff --git a/docs/img/07.png b/docs/img/07.png new file mode 100644 index 0000000..58f32f9 --- /dev/null +++ b/docs/img/07.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:a4d3a8d8b169d25b27fa1374d76c0eaaadcdb6d0b55e47ff9544a4b0c855e5e2 +size 8839 diff --git a/docs/img/08.png b/docs/img/08.png new file mode 100644 index 0000000..1c50c9d --- /dev/null +++ b/docs/img/08.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:93056c1f6b05dec0c6c19ce9afaba031a02e3a0a4978c36e6c43d671527c7e99 +size 16692 diff --git a/docs/img/09.png b/docs/img/09.png new file mode 100644 index 0000000..ce85597 --- /dev/null +++ b/docs/img/09.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:550669ea7d730101b2a18c1e7e826c333baf7a8b300948d0611b811fa4416132 +size 98505 diff --git a/docs/img/10.png b/docs/img/10.png new file mode 100644 index 0000000..c76c981 --- /dev/null +++ b/docs/img/10.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:3eaf74e6abc7f143f52ed6e3b37b60483d627796bfcc89926e19ab2e700c13ae +size 23931 diff --git a/docs/img/11.png b/docs/img/11.png new file mode 100644 index 0000000..c7bca4e --- /dev/null +++ b/docs/img/11.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:30b0aa1ffbaa92c0d47b25f146a254b1e6f74b8735e6f497d6cda049a20cc421 +size 29984 diff --git a/docs/img/12.png b/docs/img/12.png new file mode 100644 index 0000000..b8662d7 --- /dev/null +++ b/docs/img/12.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:73c987e2ea7c385d09e9ec60de6cbe744589b0604ce643e2314dd0da1fb5154d +size 38661 diff --git a/docs/img/123.png b/docs/img/123.png new file mode 100644 index 0000000..9e2bce1 --- /dev/null +++ b/docs/img/123.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:99834e7ede433c9eb8e5b60125248687d7099cc8b9ac790e3dcaaeaf5046e636 +size 81687 diff --git a/docs/img/13.png b/docs/img/13.png new file mode 100644 index 0000000..a03d3f3 --- /dev/null +++ b/docs/img/13.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:1e5dffb89092a1a2d79776b2d8a787140e954b129ac17a8dc3855b2d5e72707c +size 61564 diff --git a/docs/img/14.png b/docs/img/14.png new file mode 100644 index 0000000..51efc35 --- /dev/null +++ b/docs/img/14.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:e322782d42f3e6230e3cca4adc473db95a7f069245d0e228c72de6efe298d884 +size 186149 diff --git a/docs/img/15.png b/docs/img/15.png new file mode 100644 index 0000000..b96d1e5 --- /dev/null +++ b/docs/img/15.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:8e7ca8e33f709ee8a716b1d15001b58e4415fbc29e9a66705fac96714244dfbe +size 55952 diff --git a/docs/img/16.png b/docs/img/16.png new file mode 100644 index 0000000..e1d6445 --- /dev/null +++ b/docs/img/16.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:ff09e9a526e067ba9621fff80b1dc0e19b50bb4e037100bba4d3e81ec15173e2 +size 88906 diff --git a/docs/img/17.png b/docs/img/17.png new file mode 100644 index 0000000..2274bb6 --- /dev/null +++ b/docs/img/17.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:0d43e8ed03ca1c3dbffe13d76e0967e306b87744561b4194401fce7149a172bd +size 19882 diff --git a/docs/img/18.png b/docs/img/18.png new file mode 100644 index 0000000..3098e4f --- /dev/null +++ b/docs/img/18.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:11bd5ea2bb94973895fddb044b88a7bfa0e4dd72b097eda47819a6c1711a6bd0 +size 23625 diff --git a/docs/img/19.png b/docs/img/19.png new file mode 100644 index 0000000..805c47a --- /dev/null +++ b/docs/img/19.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:3115cabaac341300f22c625f9d7937228bc2a6698529d876c34c014f0c3781e3 +size 32270 diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 0000000..47a3946 --- /dev/null +++ b/docs/index.md @@ -0,0 +1,28 @@ +--- +comments: true +title: 前言 +--- + +## 狐狸怎么叫？ + +本文档会讲解一些联邦宇宙之间的沟通以及 `mastodon` 的一些进阶问题。 + +本文档使用的 `mastodon` 版本为 `v4.0.0+`，一些地方可能和低版本不同，并且立足于**网页端**。 + +![01](./img/01.png) + +在登陆状态下的网页端左下角显示的那串数字就是当前站点使用的 `mastodon` 版本。 + +## 施工中 + +- [ ] 帐号迁移、删除介绍 + +- [ ] 第三方 app + +- [ ] 其它联邦应用介绍 + +- [ ] 联邦应用兼容性 + +- [ ] 极♿进阶用户介绍，一种不想建站但还是想了解站点怎么运行之类的介绍 + +- [ ] 建站，在联邦宇宙中最好的方式就是自己建站 diff --git a/docs/site.md b/docs/site.md new file mode 100644 index 0000000..798efb2 --- /dev/null +++ b/docs/site.md @@ -0,0 +1,34 @@ +--- +comments: true +title: 认识站点 +--- + +## 小区比喻 + +接下来就将这些个星球比喻成一个小区吧，一些小区可能对入住人员没有限制，而一些小区或许对于入住人员有所要求……比如只接纳「对自我认知是一个狐狸」、「二次元」、「会说多种语言」、「讲话不能带字母 e」等等等等。 + +在一开始不妨根据自己的特质去尽量寻找相和的「小区」吧，同好们住在一个「小区」内进行交流也更能让人起兴致。 + +### 本站 + +如果现在，已经在一个「小区」内入住了，那么自然是听听邻居们在谈论些什么了： + +![02](./img/02.png) + +在网页端点击「本地」按钮，就是查看同在一个站点用户的发言了，一般也称作「本地轴」、「本站轴」、「LTL(local time line)」。 + +### 主页 + +依据前文所说，基于 `ActivePub` 的程序之间可以相互沟通，不妨想象成关注了其它站点的人相当于「订阅」了 ta 的消息，就像订阅了一份杂志、报纸一样，在「主页」上，就能查看所关注之人的消息了（理所当然，也可以关注本「小区」的人）。 + +![03](./img/03.png) + +### 跨站 + +那么「小区」受到了来自「住户」订阅的消息，这些消息有可能经历很长一段距离的颠簸，或许来自其它国家甚至其它大洋，自然想着不能浪费，要给个地方好好展示出来，那么这个地方就是「跨站」。 + +![03](./img/04.png) + +一般也称作「跨站轴」、「世界轴」、「FTL (Federation time line)」。 + +*所以，一个站点上的跨站轴跟整个站点用户关注的人是有很大关系的，如果一个站点是一个只有几个人的小型站点，关注的人不多，那么自然跨站轴上的内容就很……贫瘠。 \ No newline at end of file diff --git a/docs/user.md b/docs/user.md new file mode 100644 index 0000000..7fd195b --- /dev/null +++ b/docs/user.md @@ -0,0 +1,49 @@ +--- +comments: true +title: 用户管理 +--- + + +![10](./img/10.png) + +如果是对于其他用户，其「更多」菜单会有所不同，具体来说： + +### 隐藏和屏蔽 + +关于隐藏和屏蔽的区别，其实 `mastodon` 就做出了相应解释。 + +![11](./img/11.png) + +➊**隐藏**：对方不会知道你隐藏了 ta，同时还是设置一个持续时间以及是否接收来自 ta 的通知。 + +适合用来应付关注了某人然后 ta 在某个时间段开始发「疯」，大量发送一些不敢兴趣的内容但是又不想取关 ta 。 + +![12](./img/12.png) + +🦊[狐说站](https://foxsay.southfox.me/@SouthFox/108786867678818191)将默认参数设置成了 1 天并且接收通知。 + +➋**屏蔽**：对方知道你屏蔽了 ta，同时还会直接移除关注关系。 + +➎**屏蔽整个站点**：这适合拿来应付那些让自己感到不安的站点，要小心使用此功能，因为他会直接移除整个站点下帐号的关注关系。 + +➌过滤此嘟文，`v4.0.0+` 功能，可单独过滤此嘟文，并指定到某一个特定的过滤器下，下述过滤功能。 + +### 其它 + +![14](./img/14.png) + +在其它用户的个人主页上也可以进行一些动作，例如： + +**➊特别关注：**点击此铃铛后将会在 ta 发贴时在通知里推送一条消息。 + +**➋隐藏转贴**：可以在主页上隐藏此用户的转贴，但个人资料内依然正常显示转贴，适用于此账户是一个转贴狂魔的情况。 + +**➌更改订阅语言：**如果关注了一个多语言帐号，而又只想关注对方一个特定语言时可以使用此功能，依赖于对方有无正确标识语言，`v4.0.0+` 功能。 + +**➍推荐此用户：**在自己的个人资料页显示一条推荐。 + +**➎添加、移除列表：**同下述的列表功能，不过在此处可以更加方便添加。 + +➏➐➑➒：同上。 + +**➓备注：**可以添加一个备注以便识别，适用于对方是一个经常换头像和昵称的人。 \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 0000000..db63692 --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,32 @@ +site_name: Foxsay Mastodon Help +site_url: "https://foxsay-help.southfox.me" + +markdown_extensions: + - toc: + baselevel: 3 + permalink: "#" + +theme: + name: material + language: zh + custom_dir: overrides + include_search_page: false + search_index_only: false + + features: + - search.highlight + - search.suggest + - search.share + - toc.integrate + +plugins: + - search: + separator: '[\s\u200b\-]' + +nav: + - 前言: 'index.md' + - 认识联邦宇宙: 'fedi.md' + - 基本使用: 'base.md' + - 用户管理: 'user.md' + - 内容管理: 'content.md' + - 进阶问题: 'advanced.md' diff --git a/overrides/partials/comments.html b/overrides/partials/comments.html new file mode 100644 index 0000000..1a1450f --- /dev/null +++ b/overrides/partials/comments.html @@ -0,0 +1,10 @@ +{% if page.meta.comments %} +
+ +{% endif %}