# Mirror启航系列教程1-写文章

By [BigDao](https://paragraph.com/@bigdao) · 2021-11-08

---

今天开始使用`Mirror`，看看这个`SocialFi`到底怎样。一边学习一边留下足迹，以后的时光也可以来回顾一番。

`Mirror`的界面非常非常简洁，对新手比较友好，其主体也是以文章为承载，在这个平台上叫做`Entry`（有点像维基百科👽）。首先我就来学习下这个`Entry`到底是啥个玩意。

其实基本上来说，`Mirror`上的文章依托`Markdown`语法，这也是目前最为流行的文档编写方式，所以上手还是比较快的。`Mirror`的编辑器可以使用富媒体块撰写条目，例如图片，视频，**与古典互联网不同的是，它还可以融入加密经济模块**，例如众筹和拍卖。这应该是`Mirror`最棒的利器。

模式
--

在`Edit`模式下，进行撰写。进入`Preview`模式，可以预览你的文档。你可以在工具栏中点击相关按钮进行切换（在我写本篇的时候，其实并没有看到这些模式，可能已经去掉了，毕竟`markdown`的文档本就是所见即所得的）

导入文章
----

如果想要从其它地方导入文章，例如`Medium`或`Substack`，打开导航中的二级菜单`•••`，然后点击`Import entry`。接着，输入你要导入的源文`URL`。该链接会被转化成`markdown`，并设置为你当前文章的内容。**请仅导入你自己创建并拥有的内容。**

创建模块
----

要想创建一个多媒体或经济模块，首先要在文档内点击你想放置这些模块的地方。接下来，点击工具栏中的`Blocks`区域，或者使用快捷键`⌘+/`呼出。此时模块菜单将会展现，罗列了所有可用的模块。选择一个模块会提示你输入相关信息。当你觉得OK后，确认信息，将模块插入到文档中。

![](https://storage.googleapis.com/papyrus_images/64d123e308308a3cf01176b58a1836e30268f46f3da2716b3a96aa9b5262e971.svg)

模块
--

在`Mirror`上嵌入的多媒体和经济模块，通过简单的格式约定进行识别：方法很简单，就是直接贴上超链接就可以（其实从后面也可以得知，**Mirror会监听纯链接的拷贝，只要是各种协议的链接，都会尝试转换为对应的模块**）。要确保这一行仅包含一个链接。如下示例嵌入一个`Youtube`视频：

    [Powers of Ten](https://www.youtube.com/watch?v=0fKBhvDjuy0)
    

[![]({{DOMAIN}}/editor/youtube/play.png)](https://www.youtube.com/watch?v=0fKBhvDjuy0)

我们已经决定解析基本链接， 而不是去介绍一种`Mirror`专用的语法 -- 为了保证可移植性。如果`markdown`是用`Mirror`渲染的，你会看到一个`Mirror`模块。而若在其它地方，你则会看到一个简单的纯文本链接。有很多小集成，我们每周都会添加更多。

NFTs
----

创建一个链接以嵌入一个`NFT`。`URL`以`ethereum://`协议为前缀，紧接着是`address/id`。目前支持图片，音频，视频，和文本嵌入。`Mirror`目前支持`EthBlock.art`，`Foundation`，`Rarible`，`SuperRare`和`Zora`这些`NFT`平台。

    [NFT Example](ethereum://0xb932a70a57673d89f4acffbe830e8ed7f75fb9e0/16297)
    

ethereum://0xb932a70a57673d89f4acffbe830e8ed7f75fb9e0/16297

众筹
--

[创建一个众筹](https://mirror.xyz/dashboard/crowdfunds)并且部署它。部署完后，在`Embed crowdfund` 部分会显示一小段代码。拷贝粘贴到文档中。效果就会像下面例子这样，只是变为了你专属的众筹地址。

    [BURN ALPHA NOVEL](https://etherscan.io/address/0x95d0A89943E0e3e05d290Fc07462c148EB6a11Ff)
    

[crowdfund://0x95d0A89943E0e3e05d290Fc07462c148EB6a11Ff?network=homestead](https://etherscan.io/address/0x95d0A89943E0e3e05d290Fc07462c148EB6a11Ff)

拍卖
--

[创建一个拍卖](https://mirror.xyz/dashboard/auctions)并部署它。部署完成后，会在`Embed auction`区域展示一段代码。同样复制粘贴。会像下面展示出来，并且配有你专属拍卖地址和`tokenID`。

    [Token #1522](https://etherscan.io/address/0xabEFBc9fD2F806065b4f3C237d4b59D9A97Bcac7)
    

[auction://0xabEFBc9fD2F806065b4f3C237d4b59D9A97Bcac7?network=mainnet&tokenId=1522](https://etherscan.io/address/0xabEFBc9fD2F806065b4f3C237d4b59D9A97Bcac7)

图片
--

嵌入图片可以拖拽并放入编辑器中，在模块菜单中，选择`Image`，或者手动创建一个`markdown`的图片标签。定义`width`和`height`参数可以在加载之前预留图片空间，这些在上传一张图片到`Mirror`时会被自动设置上。

    ![Image caption](https://images.mirror-media.xyz/publication-images/589ec9e9-59a2-4505-ba83-35210d01c223.jpeg?height=1180&width=1588)
    

![](https://storage.googleapis.com/papyrus_images/5f7e4a5dd2b47d669ad3a411ee16c4496e77fe01ed975e15671db247a62289cb.jpg)

链接预览
----

`Mirror`对于所有链接都展示了一种渐进增强的预览效果，这些链接只要基于[OpenGraph tags](https://ogp.me/)的通用标准即可。

    [Mirror](https://mirror.xyz)
    

[https://mirror.xyz](https://mirror.xyz)

Twitter
-------

你还可以嵌入一条单个推文，甚至一整个推文主题到`Mirror`中，只需要插入任何推文的`URL`链接就行。

    [Mirror’s first tweet](https://twitter.com/viamirror/status/1325856116748726273)
    

[https://twitter.com/viamirror/status/1325856116748726273](https://twitter.com/viamirror/status/1325856116748726273)

Youtube
-------

上文已经介绍过了，直接粘贴链接就行

嵌入视频
----

还可以插入一个外部托管的视频链接，以此来嵌入一个`.mp4`视频。并能够设置`autoplay`，`muted`，`loop`，和`controls`这些周边参数。确保你手动设置了`width`和`height`参数，来为视频预留垂直空间。

    [Powers of Ten](https://jkm-library.s3.amazonaws.com/blocks/powers-of-10.mp4?height=480&width=640&autoplay=true&loop=true&muted=true)
    

[https://jkm-library.s3.amazonaws.com/blocks/powers-of-10.mp4?height=480&width=640&autoplay=true&loop=true&muted=true](https://jkm-library.s3.amazonaws.com/blocks/powers-of-10.mp4?height=480&width=640&autoplay=true&loop=true&muted=true)

iFrames
-------

还可以创建一个`iFrame`模块，以此来嵌入任何网页。比如需要一个互动的`WebGL`内容时，这就很有用处，如下示例，简单设置`display=iframe`为`query`参数，即可达到效果

    [ThreeJS Demo](https://threejs.org/examples/webgl_water_flowmap.html?display=iframe)
    

[https://threejs.org/examples/webgl\_water\_flowmap.html?display=iframe](https://threejs.org/examples/webgl_water_flowmap.html?display=iframe)

布局尺寸
----

如果你想为文章创建更具编辑性的布局，可以考虑为特定媒体块自定义布局尺寸。支持的模块类型有图片，视频，`Youtube`和`iFrame`。

模块尺寸是通过一个`query`参数设置的，可以从`medium`和`large`中选择一个值。比如，下面是一个`large`图片延伸到了页面边缘。

    ![](https://images.mirror-media.xyz/publication-images/da461938-5ccf-4397-aa6d-d082cbba2128.jpeg?height=1533&width=2300&size=large)
    

![](https://storage.googleapis.com/papyrus_images/f5479f67771d32ad0d5e1daeb9babd4ee65ce42bfdf6738e700cb5da84178b2d.svg)

展望未来
----

`Mirror`是一个新项目，我们的编辑器聚焦在快速创建一些新的经济工具，以支持大家更好的写作。接下来我们计划引入一个全新的编辑器，支持就地编辑，移除编辑和预览模式之间的切换。在此之前，感谢你的耐心，还有，[欢迎随时反馈](https://discord.gg/6d7tsjPBjS)

结语
--

这是我的第一篇`Mirror`文章，一边学习一边写，主要是看的官方文档然后记录下来。分享给中文世界的朋友们。

参考链接
----

[https://mirror.xyz/dashboard/guide/editor](https://mirror.xyz/dashboard/guide/editor)

---

*Originally published on [BigDao](https://paragraph.com/@bigdao/mirror-1)*
