JZTXT

在博客园写第一篇博客，附带极简设置

发布时间 2023-09-08 10:39:07作者: 不要划水

一、注册

首先进入博客园官网注册账号，然后在我的博客那里申请，等待通过即可。

二、选择合适的编辑器

写博文通常采用Markdown。Markdown 是一种轻量级标记语言。 它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 XHTML(或者HTML)文档。许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。

个人一直使用Typora(新版本收费)。但网上也有在vscode安装博客园Cnblogs客户端插件写博客。也可以使用VNote，还有一些国产的MD编辑器也可以。但最重要的问题是图片上传图床是否便捷，有好方法的请留言。

三、如何编辑md

一级标题到六级标题、代码块、公式块、有序列表、无序列表、表格、链接、图片等。

建议参考编辑器的快捷键，也可以进入源代码模式了解源码。

markdown源码效果对比，快速入门

四、博客布局

左侧宽栏

文章内容

不同的模板适合不同的内容。

如：

概念介绍模板：目录、简介（概念，目的，用途等）、代码演示、总结、参考文献

问题解决模板：目录、问题描述、核心原因、解决步骤、总结、参考文献

编码技巧模板：目录、应用场景、传统解决方案、存在问题、新的解决方案、优缺点、参考文献

记录BUG模板：项目场景、问题描述、原因分析、解决方案、参考文献

写作要点（杂文除外）：

（1）文章避免太长；

（2）不要带入个人情感；

（3）使用书面语，避免口水话；

（4）排版清晰；

右侧栏

内容分类：我的标签：(按技术大类/阶段归纳)，如：

  • 前端基础(文章数目)
  • java基础总结(12)
  • Javascript学习总结(27)
  • Maven学习总结(12)
  • MySQL学习总结(9)
  • NginX学习总结(8)
  • 杂文总结(12)

内容分类：我的随笔：(按细粒度技术归纳)，如：

  • jQuery(文章数目)
  • javascript(10)
  • HTML5(23)
  • CSS3(20)
  • JavaSe(15)
  • javaWeb(10)
  • 杂文(12)

时间分类：随笔档案：(按时间归纳)，如：

  • 2023年2月(1)
  • 2022年6月(1)
  • 2022年5月(1)
  • 更多

阅读排行榜

推荐排行榜

最新评论

五、博客相关配置

第一、我的博客->管理>设置->申请JS权限

第二、博客皮肤，选择LessIsMoreRight

第三、代码高亮，选择prismjs，代码字体Dank Mono，勾选显示行号，浅色模式主题prism-duotone-light，深色模式主题prism-vsc-dark-plus

第四、博客侧边栏公告

第五、页面定制 CSS 代码，不必禁用模板默认css

/*重置属性*/
*{margin: 0;															/*外边距属性*/
padding: 0;																/*内边距属性*/
-moz-box-sizing: border-box;											/* 火狐浏览器 */
-webkit-box-sizing: border-box;											/* webkit内核浏览器 */
box-sizing: border-box; 												/*内边距和边框是在元素设置的宽度和高度之内进行绘制的*/
}
body{font-size: 16px;font-family: "微软雅黑";color: #222222;}  			/*字体，大小，颜色*/
b{font-weight: normal;}  												/*粗体重置，便于当作普通标签用CSS美化*/
i{font-style: normal;}   												/*斜体重置，便于当作普通标签用CSS美化*/
a,a:hover,a:active{text-decoration: none;color:#222222;}  				/*鼠标点击状态重置*/
input,textarea,select{outline: none;}  									/*去掉点击文本框时，轮廓被选中的状态*/
img{border: none;vertical-align: top;}  								/*图片边框重置，垂直对齐方式顶部对齐*/
li{list-style: none;} 													/*列表标志重置*/
.fl{float: left;} 														/*左浮动*/
.fr{float: right;} 														/*右浮动*/
.cl{clear: both;} 														/*清除两侧浮动*/
.clearfix::after{														/*伪类方法，防止高度塌陷*/
	content: "";															/*添加空内容*/
	display: table;															/*转成表格元素*/
	clear: both;															/*清除两侧浮动*/
}
/*修改属性*/
/*生成博客目录的CSS*/
#uprightsideBar{
    font-size:16px;
    font-family:Arial, Helvetica, sans-serif;
    text-align:left;
    position:fixed;
    top:30%;
    left:0px;
    width: auto;
    height: auto; 
}
#sideBarTab{
    float:left;
    font-size: 20px;
    width:30px; 
    border:1px solid #e5e5e5;
    border-right:none;
    text-align:center;
    background: #f6f6f6;
}
#sideBarTab h2{
    color: #497837;
}
#sideBarContents{
    float:left;
    overflow:auto; 
    overflow-x:hidden;!important;
    font-weight: bold;
    width:200px;
    min-height:108px;
    max-height:600px;
    border:1px solid #e5e5e5;
    border-right:none; 
    background: #f6f6f6;
}
#sideBarContents dl{
    margin:0;
    padding:0;
}
#sideBarContents dt{
    margin-top:5px;
    margin-left:5px;
}
#sideBarContents dd, dt {
    cursor: pointer;
}
#sideBarContents dd:hover, dt:hover {
    color:#A7995A;
}

第六、页首Html代码

<script type="text/javascript">
/*
    功能：生成博客目录的JS工具
    测试：IE8，火狐，google测试通过
    实现原理：首先通过调用 DOM 方法，判断出浏览器滚动条（scroll bar）的当前位置，记为 currentPos；然后计算出目标标题（target title）的距页面顶端的距离，记为 finalPos；最后通过一定的算法实现平滑过度。
    孤傲苍狼
    2014-5-11
*/
var BlogDirectory = {
    /*
        获取元素位置，距浏览器左边界的距离（left）和距浏览器上边界的距离（top）
    */
    getElementPosition:function (ele) {        
        var topPosition = 0;
        var leftPosition = 0;
        while (ele){              
            topPosition += ele.offsetTop;
            leftPosition += ele.offsetLeft;        
            ele = ele.offsetParent;     
        }  
        return {top:topPosition, left:leftPosition}; 
    },

    /*
    获取滚动条当前位置
    */
    getScrollBarPosition:function () {
        var scrollBarPosition = document.body.scrollTop || document.documentElement.scrollTop;
        return  scrollBarPosition;
    },
    
    /*
    移动滚动条，finalPos 为目的位置，internal 为移动速度
    */
    moveScrollBar:function(finalpos, interval) {

        //若不支持此方法，则退出
        if(!window.scrollTo) {
            return false;
        }

        //窗体滚动时，禁用鼠标滚轮
        window.onmousewheel = function(){
            return false;
        };
          
        //清除计时
        if (document.body.movement) { 
            clearTimeout(document.body.movement); 
        } 

        var currentpos =BlogDirectory.getScrollBarPosition();//获取滚动条当前位置

        var dist = 0; 
        if (currentpos == finalpos) {//到达预定位置，则解禁鼠标滚轮，并退出
            window.onmousewheel = function(){
                return true;
            }
            return true; 
        } 
        if (currentpos < finalpos) {//未到达，则计算下一步所要移动的距离
            dist = Math.ceil((finalpos - currentpos)/10); 
            currentpos += dist; 
        } 
        if (currentpos > finalpos) { 
            dist = Math.ceil((currentpos - finalpos)/10); 
            currentpos -= dist; 
        }
        
        var scrTop = BlogDirectory.getScrollBarPosition();//获取滚动条当前位置
        window.scrollTo(0, currentpos);//移动窗口
        if(BlogDirectory.getScrollBarPosition() == scrTop)//若已到底部，则解禁鼠标滚轮，并退出
        {
            window.onmousewheel = function(){
                return true;
            }
            return true;
        }
        
        //进行下一步移动
        var repeat = "BlogDirectory.moveScrollBar(" + finalpos + "," + interval + ")"; 
        document.body.movement = setTimeout(repeat, interval); 
    },
    
    htmlDecode:function (text){
        var temp = document.createElement("div");
        temp.innerHTML = text;
        var output = temp.innerText || temp.textContent;
        temp = null;
        return output;
    },

    /*
    创建博客目录，
    id表示包含博文正文的 div 容器的 id，
    mt 和 st 分别表示主标题和次级标题的标签名称（如 H2、H3，大写或小写都可以！），
    interval 表示移动的速度
    */
    createBlogDirectory:function (id, mt, st, interval){
         //获取博文正文div容器
        var elem = document.getElementById(id);
        if(!elem) return false;
        //获取div中所有元素结点
        var nodes = elem.getElementsByTagName("*");
        //创建博客目录的div容器
        var divSideBar = document.createElement('DIV');
        divSideBar.className = 'uprightsideBar';
        divSideBar.setAttribute('id', 'uprightsideBar');
        var divSideBarTab = document.createElement('DIV');
        divSideBarTab.setAttribute('id', 'sideBarTab');
        divSideBar.appendChild(divSideBarTab);
        var h2 = document.createElement('H2');
        divSideBarTab.appendChild(h2);
        var txt = document.createTextNode('目录导航');
        h2.appendChild(txt);
        var divSideBarContents = document.createElement('DIV');
        divSideBarContents.style.display = 'none';
        divSideBarContents.setAttribute('id', 'sideBarContents');
        divSideBar.appendChild(divSideBarContents);
        //创建自定义列表
        var dlist = document.createElement("dl");
        divSideBarContents.appendChild(dlist);
        var num = 0;//统计找到的mt和st
        mt = mt.toUpperCase();//转化成大写
        st = st.toUpperCase();//转化成大写
        //遍历所有元素结点
        for(var i=0; i<nodes.length; i++)
        {
            if(nodes[i].nodeName == mt|| nodes[i].nodeName == st)    
            {
                //获取标题文本
                var nodetext = nodes[i].innerHTML.replace(/<\/?[^>]+>/g,"");//innerHTML里面的内容可能有HTML标签，所以用正则表达式去除HTML的标签
                nodetext = nodetext.replace(/ /ig, "");//替换掉所有的 
                nodetext = BlogDirectory.htmlDecode(nodetext);
                //插入锚        
                nodes[i].setAttribute("id", "blogTitle" + num);
                var item;
                switch(nodes[i].nodeName)
                {
                    case mt:    //若为主标题 
                        item = document.createElement("dt");
                        break;
                    case st:    //若为子标题
                        item = document.createElement("dd");
                        break;
                }
                
                //创建锚链接
                var itemtext = document.createTextNode(nodetext);
                item.appendChild(itemtext);
                item.setAttribute("name", num);
                item.onclick = function(){        //添加鼠标点击触发函数
                    var pos = BlogDirectory.getElementPosition(document.getElementById("blogTitle" + this.getAttribute("name")));
                    if(!BlogDirectory.moveScrollBar(pos.top, interval)) return false;
                };            
                
                //将自定义表项加入自定义列表中
                dlist.appendChild(item);
                num++;
            }
        }
        
        if(num == 0) return false; 
        /*鼠标进入时的事件处理*/
        divSideBarTab.onmouseenter = function(){
            divSideBarContents.style.display = 'block';
        }
        /*鼠标离开时的事件处理*/
        divSideBar.onmouseleave = function() {
            divSideBarContents.style.display = 'none';
        }

        document.body.appendChild(divSideBar);
    }
    
};

window.onload=function(){
    /*页面加载完成之后生成博客目录*/
    BlogDirectory.createBlogDirectory("cnblogs_post_body","h2","h3",20);
}
</script>

第七、页脚Html代码

第八、其它设置

勾选允许 MetaWeblog 博客客户端访问。

参考文献

https://www.cnblogs.com/climy/p/10787495.html
https://editor.csdn.net/md/
https://www.cnblogs.com/xdp-gacl/p/3718879.html
https://www.cnblogs.com/esofar/p/cnblogs-theme-silence.html