@@ -7,14 +7,14 @@ ggtree: an R package for visualization and annotation of phylogenetic trees with

 [![releaseVersion](https://img.shields.io/badge/release%20version-1.10.0-green.svg?style=flat)](https://bioconductor.org/packages/ggtree)

 [![develVersion](https://img.shields.io/badge/devel%20version-1.11.1-green.svg?style=flat)](https://github.com/guangchuangyu/ggtree)

 [![Bioc](http://www.bioconductor.org/shields/years-in-bioc/ggtree.svg)](https://www.bioconductor.org/packages/devel/bioc/html/ggtree.html#since)

-[![total](https://img.shields.io/badge/downloads-21527/total-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree)

+[![total](https://img.shields.io/badge/downloads-21911/total-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree)

 [![month](https://img.shields.io/badge/downloads-1156/month-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree)

 [![Project Status: Active - The project has reached a stable, usable

 state and is being actively

 developed.](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active)

 [![codecov](https://codecov.io/gh/GuangchuangYu/ggtree/branch/master/graph/badge.svg)](https://codecov.io/gh/GuangchuangYu/ggtree)

-[![Last-changedate](https://img.shields.io/badge/last%20change-2017--11--24-green.svg)](https://github.com/GuangchuangYu/ggtree/commits/master)

+[![Last-changedate](https://img.shields.io/badge/last%20change-2017--12--04-green.svg)](https://github.com/GuangchuangYu/ggtree/commits/master)

 [![GitHub

 forks](https://img.shields.io/github/forks/GuangchuangYu/ggtree.svg)](https://github.com/GuangchuangYu/ggtree/network)

 [![GitHub

@@ -59,8 +59,8 @@ their covariates and other associated data. ***Methods in Ecology and

 Evolution***. 2017, 8(1):28-36.

 [![doi](https://img.shields.io/badge/doi-10.1111/2041--210X.12628-green.svg?style=flat)](http://dx.doi.org/10.1111/2041-210X.12628)

-[![Altmetric](https://img.shields.io/badge/Altmetric-335-green.svg?style=flat)](https://www.altmetric.com/details/10533079)

-[![citation](https://img.shields.io/badge/cited%20by-49-green.svg?style=flat)](https://scholar.google.com.hk/scholar?oi=bibs&hl=en&cites=7268358477862164627)

+[![Altmetric](https://img.shields.io/badge/Altmetric-333-green.svg?style=flat)](https://www.altmetric.com/details/10533079)

+[![citation](https://img.shields.io/badge/cited%20by-51-green.svg?style=flat)](https://scholar.google.com.hk/scholar?oi=bibs&hl=en&cites=7268358477862164627)

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

@@ -71,7 +71,7 @@ Evolution***. 2017, 8(1):28-36.

 ### Download stats

 [![download](http://www.bioconductor.org/shields/downloads/ggtree.svg)](https://bioconductor.org/packages/stats/bioc/ggtree)

-[![total](https://img.shields.io/badge/downloads-21527/total-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree)

+[![total](https://img.shields.io/badge/downloads-21911/total-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree)

 [![month](https://img.shields.io/badge/downloads-1156/month-blue.svg?style=flat)](https://bioconductor.org/packages/stats/bioc/ggtree)

 <img src="docs/images/dlstats.png" width="890"/>

@@ -344,7 +344,7 @@

 			<h1>Documentation </h1>

 			<p><link rel="stylesheet" href="https://guangchuangyu.github.io/css/font-awesome.min.css"></p>

-<section id="vignettes" class="level2">

+<div id="vignettes" class="section level2">

 <h2><i class="fa fa-book"></i> Vignettes</h2>

 <ul>

 <li><a href="https://bioconductor.org/packages/devel/bioc/vignettes/ggtree/inst/doc/ggtree.html">ggtree</a></li>

@@ -356,10 +356,10 @@

 <li><a href="https://bioconductor.org/packages/devel/bioc/vignettes/ggtree/inst/doc/ggtreeUtilities.html">ggtree utilities</a></li>

 <li><a href="https://cran.r-project.org/web/packages/emojifont/vignettes/phylomoji.html">Phylomoji</a></li>

 </ul>

-</section>

-<section id="blog-posts" class="level2">

+</div>

+<div id="blog-posts" class="section level2">

 <h2><i class="fa fa-wordpress"></i> Blog posts</h2>

-<section id="news-and-updates" class="level3">

+<div id="news-and-updates" class="section level3">

 <h3><i class="fa fa-angle-double-right"></i> News and updates</h3>

 <ul>

 <li><a href="https://guangchuangyu.github.io/2014/12/viewing-and-annotating-phylogenetic-tree-with-ggtree">viewing and annotating phylogenetic tree with ggtree</a></li>

@@ -371,16 +371,16 @@

 <li><a href="https://guangchuangyu.github.io/2016/10/bioc-34-news-of-my-bioc-packages">BioC 3.4: NEWS of my BioC packages</a></li>

 <li><a href="https://guangchuangyu.github.io/2016/08/ggtree-paper-published">ggtree paper published</a></li>

 </ul>

-</section>

-<section id="data-manipulation" class="level3">

+</div>

+<div id="data-manipulation" class="section level3">

 <h3><i class="fa fa-angle-double-right"></i> Data manipulation</h3>

 <ul>

 <li><a href="https://guangchuangyu.github.io/2015/09/subsetting-data-in-ggtree">subsetting data in ggtree</a></li>

 <li><a href="https://guangchuangyu.github.io/2016/01/ggtree-supports-phylip-tree-format">ggtree supports phylip tree format</a></li>

 <li><a href="http://guangchuangyu.github.io/2017/01/convert-graphic-object-to-tree-object-using-treeio/">convert graphic object to tree object using treeio</a></li>

 </ul>

-</section>

-<section id="tree-visualization" class="level3">

+</div>

+<div id="tree-visualization" class="section level3">

 <h3><i class="fa fa-angle-double-right"></i> Tree visualization</h3>

 <ul>

 <li><a href="https://guangchuangyu.github.io/2015/02/ggtree---updating-a-tree-view/">ggtree - updating a tree view</a></li>

@@ -389,8 +389,8 @@

 <li><a href="https://phe-bioinformatics.github.io/blog/2017/06/14/ggtree_exploration">Growing a ggtree</a></li>

 <li><a href="https://phe-bioinformatics.github.io/blog/2017/07/07/ggtree_part2">Growing a ggtree - part 2, adding tip shapes</a></li>

 </ul>

-</section>

-<section id="tree-annotation" class="level3">

+</div>

+<div id="tree-annotation" class="section level3">

 <h3><i class="fa fa-angle-double-right"></i> Tree annotation</h3>

 <ul>

 <li><a href="https://guangchuangyu.github.io/2016/01/label-edge-number-in-ggtree">label edge number in ggtree</a></li>

@@ -406,14 +406,14 @@

 <li><a href="https://guangchuangyu.github.io/2016/10/xlim_tree-set-x-axis-limits-for-only-tree-panel/">xlim_tree: set x axis limits for only Tree panel</a></li>

 <li><a href="https://guangchuangyu.github.io/2016/12/add-layer-to-specific-panel-of-facet_plot-output/">add layer to specific panel of facet_plot output</a></li>

 </ul>

-</section>

-<section id="tree-manipulation" class="level3">

+</div>

+<div id="tree-manipulation" class="section level3">

 <h3><i class="fa fa-angle-double-right"></i> Tree manipulation</h3>

 <ul>

 <li><a href="https://guangchuangyu.github.io/2015/07/flip-and-rotate-branches-in-ggtree">flip and rotate branches in ggtree</a></li>

 </ul>

-</section>

-<section id="application" class="level3">

+</div>

+<div id="application" class="section level3">

 <h3><i class="fa fa-angle-double-right"></i> Application</h3>

 <ul>

 <li><a href="https://guangchuangyu.github.io/2016/09/ggtree-for-microbiome-data/">ggtree for microbiome data</a></li>

@@ -421,37 +421,37 @@

 <li><a href="http://guangchuangyu.github.io/2016/12/ggtree-version-of-plottree/">ggtree version of plotTree</a></li>

 <li><a href="https://guangchuangyu.github.io/2016/10/reproducible-logo-generated-by-ggtree">reproducible logo generated by ggtree</a></li>

 </ul>

-</section>

-<section id="funny-stuff" class="level3">

+</div>

+<div id="funny-stuff" class="section level3">

 <h3><i class="fa fa-angle-double-right"></i> Funny stuff</h3>

 <ul>

 <li><a href="https://guangchuangyu.github.io/2015/06/ggtree-with-funny-fonts">ggtree with funny fonts</a></li>

 <li><a href="https://guangchuangyu.github.io/2015/09/comic-phylogenetic-tree-with-ggtree-and-comicr">comic phylogenetic tree with ggtree and comicR</a></li>

 <li><a href="https://guangchuangyu.github.io/2015/12/use-emoji-font-in-r">use emoji font in R</a></li>

 </ul>

-</section>

-</section>

-<section id="slides" class="level2">

+</div>

+</div>

+<div id="slides" class="section level2">

 <h2><i class="fa fa-slideshare"></i> Slides</h2>

 <ul>

 <li><a href="https://guangchuangyu.github.io/presentation/2014-ggplot2/">Generating publication quality figures using R &amp; ggplot2</a></li>

 <li><a href="https://guangchuangyu.github.io/presentation/2016-ggtree-chinar/">ggtree for visualization and annotation of phylogenetic trees</a></li>

 </ul>

-</section>

-<section id="video" class="level2">

+</div>

+<div id="video" class="section level2">

 <h2><i class="fa fa-youtube-play"></i> Video</h2>

 <ul>

 <li><a href="https://www.youtube.com/watch?v=KcF8Ec38mzI">interactive clade highlighting</a></li>

 <li><a href="https://www.youtube.com/watch?v=lKNn4QlPO0E">interactive rotating clades</a></li>

 <li><a href="https://www.youtube.com/watch?v=SmcceRD_jxg">interactive clade labeling</a></li>

 </ul>

-</section>

-<section id="workflow" class="level2">

+</div>

+<div id="workflow" class="section level2">

 <h2><i class="fa fa-gift"></i> Workflow</h2>

 <ul>

 <li><a href="https://rpubs.com/gutijosh9430/124817">recreate a tree from a publication (<strong>Bloom</strong> <em>et al</em>, <strong><em>Science</em></strong> 2010)</a></li>

 </ul>

-</section>

+</div>

 			<aside class="copyright" role="note">

@@ -344,20 +344,20 @@

 			<h1>FAQ </h1>

 			<p><link rel="stylesheet" href="https://guangchuangyu.github.io/css/font-awesome.min.css"></p>

-<section id="installation" class="level1">

+<div id="installation" class="section level1">

 <h1><i class="fa fa-download"></i> Installation</h1>

-<section id="could-not-find-function" class="level2">

+<div id="could-not-find-function" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> Could not find function</h2>

 <p>If you got <a href="https://github.com/GuangchuangYu/ggtree/issues/12">this error</a>, please make sure you are using the latest R and <code>ggtree</code>.</p>

 <p>Packages in Bioconductor, like <code>ggtree</code>, have different release policy compare to CRAN. There are two branches, release and devel, in parallel. Release branch is more stable and only document improvement and bug fixes will commit to it. New functions will only commit to <code>devel</code> branch.</p>

 <p>Sometimes I may write blog post to introduce new functions which is not available in <code>release</code> branch, you need to install the <code>devel</code> version of <code>ggtree</code> in order to use these new functions.</p>

 <p>You can download the <code>devel</code> version of <code>ggtree</code> from <a href="http://bioconductor.org/packages/devel/bioc/html/ggtree.html" class="uri">http://bioconductor.org/packages/devel/bioc/html/ggtree.html</a> and install it, or install the github version of <code>ggtree</code>.</p>

 <p>This also applied to other of my packages, including <code>GOSemSim</code>, <code>DOSE</code>, <code>clusterProfiler</code>, <code>ReactomePA</code> and <code>ChIPseeker</code>. If you got the <code>could not find function</code> error, upgrade your installation to latest release. If the error still exists after upgrading to latest release, you need to install the devel version.</p>

-</section>

-</section>

-<section id="text-label" class="level1">

+</div>

+</div>

+<div id="text-label" class="section level1">

 <h1><i class="fa fa-text-height"></i> Text &amp; Label</h1>

-<section id="tip-label-truncated" class="level2">

+<div id="tip-label-truncated" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> Tip label truncated</h2>

 <p>ggplot2 can’t auto adjust xlim based on added text.</p>

 <pre class="r"><code>library(ggtree)

@@ -366,8 +366,8 @@ tree<-read.tree(text="(Organism1.006G249400.1:0.03977,(Organism2.022118m

 ggtree(tree) + geom_tiplab()</code></pre>

 <p>This is because the units are in two different spaces (data and pixel). Users can use xlim to allocate more space for tip label.</p>

 <pre class="r"><code>ggtree(tree) + geom_tiplab() + xlim(0, 0.06)</code></pre>

-</section>

-<section id="modify-tip-labels" class="level2">

+</div>

+<div id="modify-tip-labels" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> Modify (tip) labels</h2>

 <p>This could be easily done via the <code>%&lt;+%</code> operator to attach the modified version of the labels and than use <code>geom_tiplab</code> to display the modified version.</p>

 <pre><code>raxml_file &lt;- system.file(&quot;extdata/RAxML&quot;, &quot;RAxML_bipartitionsBranchLabels.H3&quot;, package=&quot;ggtree&quot;)

@@ -377,8 +377,8 @@ lb = get.tree(raxml)$tip.label

 d = data.frame(label=lb, label2 = paste("AA", substring(lb, 1, 5)))

 ggtree(raxml) %&lt;+% d + geom_tiplab(aes(label=label2))</code></pre>

 <p>see also <a href="https://groups.google.com/forum/?utm_medium=email&amp;utm_source=footer#!msg/bioc-ggtree/tFdFgCJ7gQA/tZ6phSgUDQAJ">1</a> and <a href="https://github.com/GuangchuangYu/ggtree/issues/106">2</a>.</p>

-</section>

-<section id="formatting-tip-labels" class="level2">

+</div>

+<div id="formatting-tip-labels" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> Formatting (tip) labels</h2>

 <p>If you want to format labels, you need to set <code>parse=TRUE</code> in <code>geom_text</code>/<code>geom_tiplab</code> and the <code>label</code> should be string that can be parsed into expression and displayed as described in <code>?plotmath</code>.</p>

 <p>For example, the tiplabels contains two parts, species name and accession number and we want to display species name in <em>italic</em>, we can use command like this:</p>

@@ -395,8 +395,8 @@ d <- data.frame(label = tr$tip.label, genus = genus,

 ggtree(tr) %<+% d + xlim(NA, 5) +

     geom_tiplab(aes(label=paste0(&#39;italic(&#39;, genus, &#39;)~bolditalic(&#39;, species, &#39;)~&#39;, geo)), parse=T)</code></pre>

 <p>see also <a href="https://groups.google.com/forum/?utm_medium=email&amp;utm_source=footer#!msg/bioc-ggtree/BA7g-npY1BM" class="uri">https://groups.google.com/forum/?utm_medium=email&amp;utm_source=footer#!msg/bioc-ggtree/BA7g-npY1BM</a>.</p>

-</section>

-<section id="avoid-overlapping-text-labels" class="level2">

+</div>

+<div id="avoid-overlapping-text-labels" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> Avoid overlapping text labels</h2>

 <p>User can use <a href="https://cran.r-project.org/web/packages/ggrepel/">ggrepel</a> package to repel overlapping text labels.</p>

 <p>For example:</p>

@@ -406,8 +406,8 @@ raxml_file <- system.file("extdata/RAxML", "RAxML_bipartitions

 raxml <- read.raxml(raxml_file)

 ggtree(raxml) + geom_label_repel(aes(label=bootstrap, fill=bootstrap))</code></pre>

 <p>For details, please refer to <a href="https://cran.r-project.org/web/packages/ggrepel/vignettes/ggrepel.html">ggrepel usage examples</a>.</p>

-</section>

-<section id="bootstrap-values-from-newick-format" class="level2">

+</div>

+<div id="bootstrap-values-from-newick-format" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> bootstrap values from newick format</h2>

 <p>It’s quite command to store <code>bootstrap</code> value as node label in <code>newick</code> format. Visualizing node label is easy using <code>geom_text2(aes(subset = !isTip, label=label))</code>.</p>

 <p>If you want to only display a subset of <code>bootstrap</code> (e.g. bootstrap &gt; 80), you can’t simply using <code>geom_text2(subset= (label &gt; 80), label=label)</code> since <code>label</code> is a character vector, which contains node label (bootstrap value) and tip label (taxa name). If we use <code>geom_text2(subset=(as.numeric(label) &gt; 80), label=label)</code>, it will also fail since <code>NAs</code> were introduced by coercion. We need to convert <code>NAs</code> to logical <code>FALSE</code>, this can be done by the following code:</p>

@@ -422,19 +422,19 @@ d$label <- as.numeric(d$label)

 d <- d[d$label > 80,]

 q + geom_text(data=d, aes(label=label))</code></pre>

-</section>

-</section>

-<section id="aesthetic-mapping" class="level1">

+</div>

+</div>

+<div id="aesthetic-mapping" class="section level1">

 <h1><i class="fa fa-map-marker"></i> <em>aesthetic</em> mapping</h1>

-<section id="inherit-aes" class="level2">

+<div id="inherit-aes" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> inherit <em>aes</em></h2>

 <pre class="r"><code>ggtree(rtree(30)) + geom_point()</code></pre>

 <p>For example, we can add symbolic points to nodes with <code>geom_point()</code> directly. The magic here is we don’t need to map <code>x</code> and <code>y</code> position of the points by providing <code>aes(x, y)</code> to <code>geom_point()</code> since it was already mapped by <code>ggtree</code> function and it serves as a global mapping for all layers.</p>

 <p>But what if we provide a <code>dataset</code> in a layer and the <code>dataset</code> doesn’t contain column of <code>x</code> and/or <code>y</code>, the layer function also try to map <code>x</code> and <code>y</code> and also others if you map them in <code>ggtree</code> function. As these variable is not available in your <code>dataset</code>, you will get the following error:</p>

 <pre><code>Error in eval(expr, envir, enclos) : object &#39;x&#39; not found</code></pre>

 <p>This can be fixed by using parameter <code>inherit.aes=FALSE</code> which will disable inheriting mapping from <code>ggtree</code> function.</p>

-</section>

-<section id="use-in-aes" class="level2">

+</div>

+<div id="use-in-aes" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> use <code>$</code> in aes</h2>

 <p>NEVER DO THIS.</p>

 <p>see the explaination in the <a href="https://github.com/hadley/ggplot2-book/blob/master/layers.rmd#aesthetic-mappings-secaes">ggplot2 book 2ed</a>:</p>

@@ -442,15 +442,15 @@ q + geom_text(data=d, aes(label=label))</code></pre>

 <p>Never refer to a variable with <code>$</code> (e.g., <code>diamonds$carat</code>) in <code>aes()</code>. This breaks containment, so that the plot no longer contains everything it needs, and causes problems if ggplot2 changes the order of the rows, as it does when facetting.</p>

 </blockquote>

 <p>see also <a href="https://groups.google.com/forum/?utm_medium=email&amp;utm_source=footer#!msg/bioc-ggtree/hViM6vRZF94/MsZT8qRgBwAJ">1</a> and <a href="https://github.com/GuangchuangYu/ggtree/issues/106">2</a>.</p>

-</section>

-</section>

-<section id="annotation" class="level1">

+</div>

+</div>

+<div id="annotation" class="section level1">

 <h1><i class="fa fa-tree"></i> Annotation</h1>

-<section id="colouring-edges-by-user-data" class="level2">

+<div id="colouring-edges-by-user-data" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> colouring edges by user data</h2>

 <p>see my blog post: <a href="http://guangchuangyu.github.io/2016/12/edge-coloring-with-user-data/">Edge coloring with user data</a> and also my answer on <a href="https://github.com/GuangchuangYu/ggtree/issues/76" class="uri">https://github.com/GuangchuangYu/ggtree/issues/76</a> and <a href="https://groups.google.com/forum/#!topic/bioc-ggtree/4GgivKqVjB8" class="uri">https://groups.google.com/forum/#!topic/bioc-ggtree/4GgivKqVjB8</a>.</p>

-</section>

-</section>

+</div>

+</div>

 			<aside class="copyright" role="note">

@@ -346,17 +346,17 @@

 			<p><link rel="stylesheet" href="https://guangchuangyu.github.io/css/font-awesome.min.css"></p>

 <p><a href="https://github.com/GuangchuangYu/featured_img">Let us know</a> if you have published using <code>ggtree</code> and your publication will be featured here.</p>

 <p><img src="../images/citation.png" width="880"/></p>

-<section id="section" class="level2">

+<div id="section" class="section level2">

 <h2><i class="fa fa-calendar"></i> 2017</h2>

 <p><a href="http://science.sciencemag.org/content/358/6364/789.full">Integrated view of <em>Vibrio cholerae</em> in the Americas</a>. *<strong>Science</strong>, 2017, 358(6364):789-793.</p>

 <p><a href="http://dx.doi.org/10.1073/pnas.1617959114">Phylogenetic analysis of the human antibody repertoire reveals quantitative signatures of immune senescence and aging</a>. <strong><em>PNAS</em></strong>, 2017, 114(5):1105-111-.</p>

 <p><a href="https://www.ncbi.nlm.nih.gov/pmc/articles/PMC5376617/">Horses in Denmark Are a Reservoir of Diverse Clones of Methicillin-Resistant and -Susceptible Staphylococcus aureus</a>. <strong><em>Frontiers in Microbiology</em></strong>, 2017, 8:543</p>

 <p><a href="https://microbiomejournal.biomedcentral.com/articles/10.1186/s40168-017-0232-3">Gut metagenomes of type 2 diabetic patients have characteristic single-nucleotide polymorphism distribution in <em>Bacteroides coprocola</em></a>. <strong><em>Microbiome</em></strong>, 2017, 5:15</p>

-</section>

-<section id="section-1" class="level2">

+</div>

+<div id="section-1" class="section level2">

 <h2><i class="fa fa-calendar"></i> 2016</h2>

 <p><a href="http://aem.asm.org/content/82/22/6788.short">Function and Phylogeny of Bacterial Butyryl Coenzyme A:Acetate Transferases and Their Diversity in the Proximal Colon of Swine</a>. <strong><em>Applied and Environmental Microbiology</em></strong>. 2016, 82(22):6788-6798.</p>

-</section>

+</div>

 			<aside class="copyright" role="note">

Binary files a/docs/images/citation.png and b/docs/images/citation.png differ

@@ -346,24 +346,24 @@

 				<p><link rel="stylesheet" href="https://guangchuangyu.github.io/css/font-awesome.min.css"> <link rel="stylesheet" href="https://guangchuangyu.github.io/css/academicons.min.css"></p>

 <p><img src="https://raw.githubusercontent.com/Bioconductor/BiocStickers/master/ggtree/ggtree.png" height="200" align="right" /></p>

-<p><a href="https://bioconductor.org/packages/ggtree"><img src="https://img.shields.io/badge/release%20version-1.10.0-blue.svg?style=flat" alt="releaseVersion" /></a> <a href="https://github.com/guangchuangyu/ggtree"><img src="https://img.shields.io/badge/devel%20version-1.11.1-blue.svg?style=flat" alt="develVersion" /></a> <a href="https://bioconductor.org/packages/stats/bioc/ggtree"><img src="https://img.shields.io/badge/downloads-21262/total-blue.svg?style=flat" alt="total" /></a> <a href="https://bioconductor.org/packages/stats/bioc/ggtree"><img src="https://img.shields.io/badge/downloads-1156/month-blue.svg?style=flat" alt="month" /></a></p>

+<p><a href="https://bioconductor.org/packages/ggtree"><img src="https://img.shields.io/badge/release%20version-1.10.0-blue.svg?style=flat" alt="releaseVersion" /></a> <a href="https://github.com/guangchuangyu/ggtree"><img src="https://img.shields.io/badge/devel%20version-1.11.1-blue.svg?style=flat" alt="develVersion" /></a> <a href="https://bioconductor.org/packages/stats/bioc/ggtree"><img src="https://img.shields.io/badge/downloads-21911/total-blue.svg?style=flat" alt="total" /></a> <a href="https://bioconductor.org/packages/stats/bioc/ggtree"><img src="https://img.shields.io/badge/downloads-1156/month-blue.svg?style=flat" alt="month" /></a></p>

 <p>The <code>ggtree</code> package extending the <em>ggplot2</em> package. It based on grammar of graphics and takes all the good parts of <em>ggplot2</em>. <em>ggtree</em> is designed for not only viewing phylogenetic tree but also displaying annotation data on the tree. <em>ggtree</em> is released within the <a href="https://bioconductor.org/packages/ggtree/">Bioconductor</a> project and the source code is hosted on <a href="https://github.com/GuangchuangYu/ggtree"><i class="fa fa-github fa-lg"></i> GitHub</a>.</p>

-<section id="authors" class="level2">

+<div id="authors" class="section level2">

 <h2><i class="fa fa-user"></i> Authors</h2>

 <p>Guangchuang Yu and Tommy Tsan-Yuk Lam, School of Public Health, The University of Hong Kong.</p>

-</section>

-<section id="citation" class="level2">

+</div>

+<div id="citation" class="section level2">

 <h2><i class="fa fa-book"></i> Citation</h2>

 <p>Please cite the following article when using <code>ggtree</code>:</p>

-<p><a href="http://dx.doi.org/10.1111/2041-210X.12628"><img src="https://img.shields.io/badge/doi-10.1111/2041--210X.12628-blue.svg?style=flat" alt="doi" /></a> <a href="https://www.altmetric.com/details/10533079"><img src="https://img.shields.io/badge/Altmetric-336-blue.svg?style=flat" alt="Altmetric" /></a> <a href="https://scholar.google.com.hk/scholar?oi=bibs&amp;hl=en&amp;cites=7268358477862164627"><img src="https://img.shields.io/badge/cited%20by-47-blue.svg?style=flat" alt="citation" /></a></p>

+<p><a href="http://dx.doi.org/10.1111/2041-210X.12628"><img src="https://img.shields.io/badge/doi-10.1111/2041--210X.12628-blue.svg?style=flat" alt="doi" /></a> <a href="https://www.altmetric.com/details/10533079"><img src="https://img.shields.io/badge/Altmetric-333-blue.svg?style=flat" alt="Altmetric" /></a> <a href="https://scholar.google.com.hk/scholar?oi=bibs&amp;hl=en&amp;cites=7268358477862164627"><img src="https://img.shields.io/badge/cited%20by-51-blue.svg?style=flat" alt="citation" /></a></p>

 <p><strong>G Yu</strong>, DK Smith, H Zhu, Y Guan, TTY Lam<sup>*</sup>. ggtree: an R package for visualization and annotation of phylogenetic trees with their covariates and other associated data. <strong><em>Methods in Ecology and Evolution</em></strong>. 2017, 8(1):28-36.</p>

-</section>

-<section id="featured-articles" class="level2">

+</div>

+<div id="featured-articles" class="section level2">

 <h2><i class="fa fa-pencil"></i> Featured Articles</h2>

 <p><img src="https://guangchuangyu.github.io/featured_img/ggtree/2015_peiyu_1-s2.0-S1567134815300721-gr1.jpg" /></p>

 <p><i class="fa fa-hand-o-right"></i> Find out more on <i class="fa fa-pencil"></i> <a href="https://guangchuangyu.github.io/ggtree/featuredArticles/">Featured Articles</a>.</p>

-</section>

-<section id="installation" class="level2">

+</div>

+<div id="installation" class="section level2">

 <h2><i class="fa fa-download"></i> Installation</h2>

 <p>Install <code>ggtree</code> is easy, follow the guide on the <a href="https://bioconductor.org/packages/ggtree/">Bioconductor page</a>:</p>

 <pre class="r"><code>## try http:// if https:// URLs are not supported

@@ -371,18 +371,18 @@ source("https://bioconductor.org/biocLite.R")

 ## biocLite("BiocUpgrade") ## you may need this

 biocLite(&quot;ggtree&quot;)</code></pre>

 <p>If you have problems when installing some of the dependent packages, please refer to the <a href="https://github.com/GuangchuangYu/ggtree/wiki/ggtree-installation">ggtree-installation</a> wiki page.</p>

-</section>

-<section id="overview" class="level2">

+</div>

+<div id="overview" class="section level2">

 <h2><i class="fa fa-cogs"></i> Overview</h2>

-<section id="getting-tree-into-r" class="level4">

+<div id="getting-tree-into-r" class="section level4">

 <h4><i class="fa fa-angle-double-right"></i> Getting tree into R</h4>

 <ul>

 <li>tree parsers: bring evolution evidences to be used/analyzed in <code>R</code></li>

 <li><code>merge_tree</code>: allows evolution evidences to be merged and compared</li>

 <li><code>fortify</code> methods: convert tree objects into tidy data frame</li>

 </ul>

-</section>

-<section id="tree-visualization-annotation" class="level4">

+</div>

+<div id="tree-visualization-annotation" class="section level4">

 <h4><i class="fa fa-angle-double-right"></i> Tree visualization &amp; annotation</h4>

 <ul>

 <li>parsing tree as a collection of nodes allows grammar of graphics to be supported</li>

@@ -390,41 +390,41 @@ biocLite(&quot;ggtree&quot;)</code></pre>

 <li>several layers and functions for tree annotation</li>

 <li>supports annotating phylogenetic trees with user’s own data</li>

 </ul>

-</section>

-<section id="tree-manipulation" class="level4">

+</div>

+<div id="tree-manipulation" class="section level4">

 <h4><i class="fa fa-angle-double-right"></i> Tree manipulation</h4>

 <ul>

 <li>helper functions for tree manipulation, make it possible to explore the tree visually</li>

 </ul>

 <p><i class="fa fa-hand-o-right"></i> Find out details and examples on <i class="fa fa-book"></i> <a href="https://guangchuangyu.github.io/ggtree/documentation/">Documentation</a>.</p>

-</section>

-</section>

-<section id="projects-that-depend-on-ggtree" class="level2">

+</div>

+</div>

+<div id="projects-that-depend-on-ggtree" class="section level2">

 <h2><i class="fa fa-code-fork"></i> Projects that depend on <em>ggtree</em></h2>

-<section id="cran-packages" class="level4">

+<div id="cran-packages" class="section level4">

 <h4><i class="fa fa-angle-double-right"></i> CRAN packages</h4>

 <ul>

 <li><a href="https://cran.r-project.org/package=harrietr">harrietr</a>: Wrangle Phylogenetic Distance Matrices and Other Utilities</li>

 </ul>

-</section>

-<section id="bioconductor-packages" class="level4">

+</div>

+<div id="bioconductor-packages" class="section level4">

 <h4><i class="fa fa-angle-double-right"></i> Bioconductor packages</h4>

 <ul>

 <li><a href="https://www.bioconductor.org/packages/LINC">LINC</a>: co-expression of lincRNAs and protein-coding genes</li>

 <li><a href="https://www.bioconductor.org/packages/LymphoSeq">LymphoSeq</a>: Analyze high-throughput sequencing of T and B cell receptors</li>

 <li><a href="https://www.bioconductor.org/packages/philr">philr</a>: Phylogenetic partitioning based ILR transform for metagenomics data</li>

 </ul>

-</section>

-<section id="other-applications" class="level4">

+</div>

+<div id="other-applications" class="section level4">

 <h4><i class="fa fa-angle-double-right"></i> Other applications</h4>

 <ul>

 <li><a href="https://bitbucket.org/biobakery/breadcrumbs">BreadCrumbs</a>: Collection of scripts for metagenomics analysis</li>

 <li><a href="https://github.com/esnapd/DegeneratePrimerTools">DegeneratePrimerTools</a>: Utilities for Creating and Validating Degenerate primers</li>

 <li><a href="https://github.com/olli0601/phyloscan">phyloscan</a>: scan phylogenies created along a genome for patterns</li>

 </ul>

-</section>

-</section>

-<section id="feedback" class="level2">

+</div>

+</div>

+<div id="feedback" class="section level2">

 <h2><i class="fa fa-comments"></i> Feedback</h2>

 <ul class="fa-ul">

 <li>

@@ -443,7 +443,7 @@ biocLite(&quot;ggtree&quot;)</code></pre>

 <i class="fa-li fa fa-commenting"></i> Join the group chat on <a href="https://twitter.com/hashtag/ggtree"><i class="fa fa-twitter fa-lg"></i></a> and <a href="http://huati.weibo.com/k/ggtree"><i class="fa fa-weibo fa-lg"></i></a>

 </li>

 </ul>

-</section>

+</div>

@@ -387,7 +387,7 @@

 <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

 <blockquote class="twitter-tweet"><p lang="en" dir="ltr">The R <a href="https://twitter.com/Bioconductor?ref_src=twsrc%5Etfw">@Bioconductor</a> package <a href="https://twitter.com/hashtag/ggtree?src=hash&amp;ref_src=twsrc%5Etfw">#ggtree</a> is now published in <a href="https://twitter.com/MethodsEcolEvol?ref_src=twsrc%5Etfw">@MethodsEcolEvol</a> <a href="https://t.co/6fvSRQo2CC">https://t.co/6fvSRQo2CC</a> <a href="https://twitter.com/hashtag/evomics2017?src=hash&amp;ref_src=twsrc%5Etfw">#evomics2017</a> <a href="https://t.co/Dwq1DD84A2">pic.twitter.com/Dwq1DD84A2</a></p>&mdash; Elin Videvall (@ElinVidevall) <a href="https://twitter.com/ElinVidevall/status/822383911258890242?ref_src=twsrc%5Etfw">January 20, 2017</a></blockquote>

 <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

-<blockquote class="twitter-tweet"><p lang="en" dir="ltr">Assortative tip coloring by text string using <a href="https://twitter.com/hashtag/ggtree?src=hash&amp;ref_src=twsrc%5Etfw">#ggtree</a> by <a href="https://twitter.com/guangchuangyu?ref_src=twsrc%5Etfw">@guangchuangyu</a> <a href="https://t.co/rocvFK3OOS">https://t.co/rocvFK3OOS</a> <a href="https://twitter.com/hashtag/phylogenetics?src=hash&amp;ref_src=twsrc%5Etfw">#phylogenetics</a> <a href="https://t.co/mEMkhZ2fVk">pic.twitter.com/mEMkhZ2fVk</a></p>&mdash; Guanyang Zhang (@GYZhang2) <a href="https://twitter.com/GYZhang2/status/811666431452450816?ref_src=twsrc%5Etfw">December 21, 2016</a></blockquote>

+<blockquote class="twitter-tweet"><p lang="en" dir="ltr">Assortative tip coloring by text string using <a href="https://twitter.com/hashtag/ggtree?src=hash&amp;ref_src=twsrc%5Etfw">#ggtree</a> by <a href="https://twitter.com/guangchuangyu?ref_src=twsrc%5Etfw">@guangchuangyu</a> <a href="https://t.co/rocvFK3OOS">https://t.co/rocvFK3OOS</a> <a href="https://twitter.com/hashtag/phylogenetics?src=hash&amp;ref_src=twsrc%5Etfw">#phylogenetics</a> <a href="https://t.co/mEMkhZ2fVk">pic.twitter.com/mEMkhZ2fVk</a></p>&mdash; Guanyang Zhang 张冠阳 (@GYZhang2) <a href="https://twitter.com/GYZhang2/status/811666431452450816?ref_src=twsrc%5Etfw">December 21, 2016</a></blockquote>

 <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

 <blockquote class="twitter-tweet"><p lang="en" dir="ltr">Featured this week: ggtree, an R package for visualization &amp; annotation of phylogenetic trees. Like it? Vote it up! <a href="https://t.co/laxtuRQDGB">https://t.co/laxtuRQDGB</a> <a href="https://t.co/zDvEBysWSQ">pic.twitter.com/zDvEBysWSQ</a></p>&mdash; LabWorm (@TheLabWorm) <a href="https://twitter.com/TheLabWorm/status/811661275889549312?ref_src=twsrc%5Etfw">December 21, 2016</a></blockquote>

 <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

@@ -401,7 +401,7 @@

 <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

 <blockquote class="twitter-tweet"><p lang="en" dir="ltr">am quite liking <a href="https://twitter.com/hashtag/ggtree?src=hash&amp;ref_src=twsrc%5Etfw">#ggtree</a> <a href="https://twitter.com/hashtag/rstats?src=hash&amp;ref_src=twsrc%5Etfw">#rstats</a> <a href="https://twitter.com/hashtag/ggplot?src=hash&amp;ref_src=twsrc%5Etfw">#ggplot</a> <a href="https://t.co/hvywS2z4ps">pic.twitter.com/hvywS2z4ps</a></p>&mdash; Nicholas E Ilott (@IlottNick) <a href="https://twitter.com/IlottNick/status/788751417746059264?ref_src=twsrc%5Etfw">October 19, 2016</a></blockquote>

 <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

-<blockquote class="twitter-tweet"><p lang="en" dir="ltr">Treespace visualization of a heuristic best tree search in <a href="https://twitter.com/hashtag/R?src=hash&amp;ref_src=twsrc%5Etfw">#R</a> package <a href="https://twitter.com/hashtag/ggtree?src=hash&amp;ref_src=twsrc%5Etfw">#ggtree</a> <a href="https://twitter.com/hashtag/phylogenetics?src=hash&amp;ref_src=twsrc%5Etfw">#phylogenetics</a> <a href="https://t.co/hnSJpIABql">pic.twitter.com/hnSJpIABql</a></p>&mdash; Alejandro Damián Serrano ⑂🌊🔬 (@antropoteuthis) <a href="https://twitter.com/antropoteuthis/status/693123105707986944?ref_src=twsrc%5Etfw">January 29, 2016</a></blockquote>

+<blockquote class="twitter-tweet"><p lang="en" dir="ltr">Treespace visualization of a heuristic best tree search in <a href="https://twitter.com/hashtag/R?src=hash&amp;ref_src=twsrc%5Etfw">#R</a> package <a href="https://twitter.com/hashtag/ggtree?src=hash&amp;ref_src=twsrc%5Etfw">#ggtree</a> <a href="https://twitter.com/hashtag/phylogenetics?src=hash&amp;ref_src=twsrc%5Etfw">#phylogenetics</a> <a href="https://t.co/hnSJpIABql">pic.twitter.com/hnSJpIABql</a></p>&mdash; 𝓐𝖑𝖊𝖏𝖆𝖓𝖉𝖗𝖔 𝕯𝖆𝖒𝖎𝖆𝖓 𝓢𝖊𝖗𝖗𝖆𝖓𝖔 ⑂ (@antropoteuthis) <a href="https://twitter.com/antropoteuthis/status/693123105707986944?ref_src=twsrc%5Etfw">January 29, 2016</a></blockquote>

 <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

 <blockquote class="twitter-tweet"><p lang="en" dir="ltr"><a href="https://twitter.com/guangchuangyu?ref_src=twsrc%5Etfw">@guangchuangyu</a> Updated to latest <a href="https://twitter.com/hashtag/ggtree?src=hash&amp;ref_src=twsrc%5Etfw">#ggtree</a> and <a href="https://twitter.com/hashtag/ggplot2?src=hash&amp;ref_src=twsrc%5Etfw">#ggplot2</a> and very impressed! Any ideas on using geom_label with tip labels to add box/fill?</p>&mdash; Jo Williams-Newkirk (@ajwnewkirk) <a href="https://twitter.com/ajwnewkirk/status/691762302492790788?ref_src=twsrc%5Etfw">January 25, 2016</a></blockquote>

 <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

@@ -7,7 +7,7 @@ weight: 10

 <p><link rel="stylesheet" href="https://guangchuangyu.github.io/css/font-awesome.min.css"></p>

-<section id="vignettes" class="level2">

+<div id="vignettes" class="section level2">

 <h2><i class="fa fa-book"></i> Vignettes</h2>

 <ul>

 <li><a href="https://bioconductor.org/packages/devel/bioc/vignettes/ggtree/inst/doc/ggtree.html">ggtree</a></li>

@@ -19,10 +19,10 @@ weight: 10

 <li><a href="https://bioconductor.org/packages/devel/bioc/vignettes/ggtree/inst/doc/ggtreeUtilities.html">ggtree utilities</a></li>

 <li><a href="https://cran.r-project.org/web/packages/emojifont/vignettes/phylomoji.html">Phylomoji</a></li>

 </ul>

-</section>

-<section id="blog-posts" class="level2">

+</div>

+<div id="blog-posts" class="section level2">

 <h2><i class="fa fa-wordpress"></i> Blog posts</h2>

-<section id="news-and-updates" class="level3">

+<div id="news-and-updates" class="section level3">

 <h3><i class="fa fa-angle-double-right"></i> News and updates</h3>

 <ul>

 <li><a href="https://guangchuangyu.github.io/2014/12/viewing-and-annotating-phylogenetic-tree-with-ggtree">viewing and annotating phylogenetic tree with ggtree</a></li>

@@ -34,16 +34,16 @@ weight: 10

 <li><a href="https://guangchuangyu.github.io/2016/10/bioc-34-news-of-my-bioc-packages">BioC 3.4: NEWS of my BioC packages</a></li>

 <li><a href="https://guangchuangyu.github.io/2016/08/ggtree-paper-published">ggtree paper published</a></li>

 </ul>

-</section>

-<section id="data-manipulation" class="level3">

+</div>

+<div id="data-manipulation" class="section level3">

 <h3><i class="fa fa-angle-double-right"></i> Data manipulation</h3>

 <ul>

 <li><a href="https://guangchuangyu.github.io/2015/09/subsetting-data-in-ggtree">subsetting data in ggtree</a></li>

 <li><a href="https://guangchuangyu.github.io/2016/01/ggtree-supports-phylip-tree-format">ggtree supports phylip tree format</a></li>

 <li><a href="http://guangchuangyu.github.io/2017/01/convert-graphic-object-to-tree-object-using-treeio/">convert graphic object to tree object using treeio</a></li>

 </ul>

-</section>

-<section id="tree-visualization" class="level3">

+</div>

+<div id="tree-visualization" class="section level3">

 <h3><i class="fa fa-angle-double-right"></i> Tree visualization</h3>

 <ul>

 <li><a href="https://guangchuangyu.github.io/2015/02/ggtree---updating-a-tree-view/">ggtree - updating a tree view</a></li>

@@ -52,8 +52,8 @@ weight: 10

 <li><a href="https://phe-bioinformatics.github.io/blog/2017/06/14/ggtree_exploration">Growing a ggtree</a></li>

 <li><a href="https://phe-bioinformatics.github.io/blog/2017/07/07/ggtree_part2">Growing a ggtree - part 2, adding tip shapes</a></li>

 </ul>

-</section>

-<section id="tree-annotation" class="level3">

+</div>

+<div id="tree-annotation" class="section level3">

 <h3><i class="fa fa-angle-double-right"></i> Tree annotation</h3>

 <ul>

 <li><a href="https://guangchuangyu.github.io/2016/01/label-edge-number-in-ggtree">label edge number in ggtree</a></li>

@@ -69,14 +69,14 @@ weight: 10

 <li><a href="https://guangchuangyu.github.io/2016/10/xlim_tree-set-x-axis-limits-for-only-tree-panel/">xlim_tree: set x axis limits for only Tree panel</a></li>

 <li><a href="https://guangchuangyu.github.io/2016/12/add-layer-to-specific-panel-of-facet_plot-output/">add layer to specific panel of facet_plot output</a></li>

 </ul>

-</section>

-<section id="tree-manipulation" class="level3">

+</div>

+<div id="tree-manipulation" class="section level3">

 <h3><i class="fa fa-angle-double-right"></i> Tree manipulation</h3>

 <ul>

 <li><a href="https://guangchuangyu.github.io/2015/07/flip-and-rotate-branches-in-ggtree">flip and rotate branches in ggtree</a></li>

 </ul>

-</section>

-<section id="application" class="level3">

+</div>

+<div id="application" class="section level3">

 <h3><i class="fa fa-angle-double-right"></i> Application</h3>

 <ul>

 <li><a href="https://guangchuangyu.github.io/2016/09/ggtree-for-microbiome-data/">ggtree for microbiome data</a></li>

@@ -84,34 +84,34 @@ weight: 10

 <li><a href="http://guangchuangyu.github.io/2016/12/ggtree-version-of-plottree/">ggtree version of plotTree</a></li>

 <li><a href="https://guangchuangyu.github.io/2016/10/reproducible-logo-generated-by-ggtree">reproducible logo generated by ggtree</a></li>

 </ul>

-</section>

-<section id="funny-stuff" class="level3">

+</div>

+<div id="funny-stuff" class="section level3">

 <h3><i class="fa fa-angle-double-right"></i> Funny stuff</h3>

 <ul>

 <li><a href="https://guangchuangyu.github.io/2015/06/ggtree-with-funny-fonts">ggtree with funny fonts</a></li>

 <li><a href="https://guangchuangyu.github.io/2015/09/comic-phylogenetic-tree-with-ggtree-and-comicr">comic phylogenetic tree with ggtree and comicR</a></li>

 <li><a href="https://guangchuangyu.github.io/2015/12/use-emoji-font-in-r">use emoji font in R</a></li>

 </ul>

-</section>

-</section>

-<section id="slides" class="level2">

+</div>

+</div>

+<div id="slides" class="section level2">

 <h2><i class="fa fa-slideshare"></i> Slides</h2>

 <ul>

 <li><a href="https://guangchuangyu.github.io/presentation/2014-ggplot2/">Generating publication quality figures using R &amp; ggplot2</a></li>

 <li><a href="https://guangchuangyu.github.io/presentation/2016-ggtree-chinar/">ggtree for visualization and annotation of phylogenetic trees</a></li>

 </ul>

-</section>

-<section id="video" class="level2">

+</div>

+<div id="video" class="section level2">

 <h2><i class="fa fa-youtube-play"></i> Video</h2>

 <ul>

 <li><a href="https://www.youtube.com/watch?v=KcF8Ec38mzI">interactive clade highlighting</a></li>

 <li><a href="https://www.youtube.com/watch?v=lKNn4QlPO0E">interactive rotating clades</a></li>

 <li><a href="https://www.youtube.com/watch?v=SmcceRD_jxg">interactive clade labeling</a></li>

 </ul>

-</section>

-<section id="workflow" class="level2">

+</div>

+<div id="workflow" class="section level2">

 <h2><i class="fa fa-gift"></i> Workflow</h2>

 <ul>

 <li><a href="https://rpubs.com/gutijosh9430/124817">recreate a tree from a publication (<strong>Bloom</strong> <em>et al</em>, <strong><em>Science</em></strong> 2010)</a></li>

 </ul>

-</section>

+</div>

@@ -7,20 +7,20 @@ weight: 20

 <p><link rel="stylesheet" href="https://guangchuangyu.github.io/css/font-awesome.min.css"></p>

-<section id="installation" class="level1">

+<div id="installation" class="section level1">

 <h1><i class="fa fa-download"></i> Installation</h1>

-<section id="could-not-find-function" class="level2">

+<div id="could-not-find-function" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> Could not find function</h2>

 <p>If you got <a href="https://github.com/GuangchuangYu/ggtree/issues/12">this error</a>, please make sure you are using the latest R and <code>ggtree</code>.</p>

 <p>Packages in Bioconductor, like <code>ggtree</code>, have different release policy compare to CRAN. There are two branches, release and devel, in parallel. Release branch is more stable and only document improvement and bug fixes will commit to it. New functions will only commit to <code>devel</code> branch.</p>

 <p>Sometimes I may write blog post to introduce new functions which is not available in <code>release</code> branch, you need to install the <code>devel</code> version of <code>ggtree</code> in order to use these new functions.</p>

 <p>You can download the <code>devel</code> version of <code>ggtree</code> from <a href="http://bioconductor.org/packages/devel/bioc/html/ggtree.html" class="uri">http://bioconductor.org/packages/devel/bioc/html/ggtree.html</a> and install it, or install the github version of <code>ggtree</code>.</p>

 <p>This also applied to other of my packages, including <code>GOSemSim</code>, <code>DOSE</code>, <code>clusterProfiler</code>, <code>ReactomePA</code> and <code>ChIPseeker</code>. If you got the <code>could not find function</code> error, upgrade your installation to latest release. If the error still exists after upgrading to latest release, you need to install the devel version.</p>

-</section>

-</section>

-<section id="text-label" class="level1">

+</div>

+</div>

+<div id="text-label" class="section level1">

 <h1><i class="fa fa-text-height"></i> Text &amp; Label</h1>

-<section id="tip-label-truncated" class="level2">

+<div id="tip-label-truncated" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> Tip label truncated</h2>

 <p>ggplot2 can’t auto adjust xlim based on added text.</p>

 <pre class="r"><code>library(ggtree)

@@ -29,8 +29,8 @@ tree<-read.tree(text="(Organism1.006G249400.1:0.03977,(Organism2.022118m

 ggtree(tree) + geom_tiplab()</code></pre>

 <p>This is because the units are in two different spaces (data and pixel). Users can use xlim to allocate more space for tip label.</p>

 <pre class="r"><code>ggtree(tree) + geom_tiplab() + xlim(0, 0.06)</code></pre>

-</section>

-<section id="modify-tip-labels" class="level2">

+</div>

+<div id="modify-tip-labels" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> Modify (tip) labels</h2>

 <p>This could be easily done via the <code>%&lt;+%</code> operator to attach the modified version of the labels and than use <code>geom_tiplab</code> to display the modified version.</p>

 <pre><code>raxml_file &lt;- system.file(&quot;extdata/RAxML&quot;, &quot;RAxML_bipartitionsBranchLabels.H3&quot;, package=&quot;ggtree&quot;)

@@ -40,8 +40,8 @@ lb = get.tree(raxml)$tip.label

 d = data.frame(label=lb, label2 = paste("AA", substring(lb, 1, 5)))

 ggtree(raxml) %&lt;+% d + geom_tiplab(aes(label=label2))</code></pre>

 <p>see also <a href="https://groups.google.com/forum/?utm_medium=email&amp;utm_source=footer#!msg/bioc-ggtree/tFdFgCJ7gQA/tZ6phSgUDQAJ">1</a> and <a href="https://github.com/GuangchuangYu/ggtree/issues/106">2</a>.</p>

-</section>

-<section id="formatting-tip-labels" class="level2">

+</div>

+<div id="formatting-tip-labels" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> Formatting (tip) labels</h2>

 <p>If you want to format labels, you need to set <code>parse=TRUE</code> in <code>geom_text</code>/<code>geom_tiplab</code> and the <code>label</code> should be string that can be parsed into expression and displayed as described in <code>?plotmath</code>.</p>

 <p>For example, the tiplabels contains two parts, species name and accession number and we want to display species name in <em>italic</em>, we can use command like this:</p>

@@ -58,8 +58,8 @@ d <- data.frame(label = tr$tip.label, genus = genus,

 ggtree(tr) %<+% d + xlim(NA, 5) +

     geom_tiplab(aes(label=paste0(&#39;italic(&#39;, genus, &#39;)~bolditalic(&#39;, species, &#39;)~&#39;, geo)), parse=T)</code></pre>

 <p>see also <a href="https://groups.google.com/forum/?utm_medium=email&amp;utm_source=footer#!msg/bioc-ggtree/BA7g-npY1BM" class="uri">https://groups.google.com/forum/?utm_medium=email&amp;utm_source=footer#!msg/bioc-ggtree/BA7g-npY1BM</a>.</p>

-</section>

-<section id="avoid-overlapping-text-labels" class="level2">

+</div>

+<div id="avoid-overlapping-text-labels" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> Avoid overlapping text labels</h2>

 <p>User can use <a href="https://cran.r-project.org/web/packages/ggrepel/">ggrepel</a> package to repel overlapping text labels.</p>

 <p>For example:</p>

@@ -69,8 +69,8 @@ raxml_file <- system.file("extdata/RAxML", "RAxML_bipartitions

 raxml <- read.raxml(raxml_file)

 ggtree(raxml) + geom_label_repel(aes(label=bootstrap, fill=bootstrap))</code></pre>

 <p>For details, please refer to <a href="https://cran.r-project.org/web/packages/ggrepel/vignettes/ggrepel.html">ggrepel usage examples</a>.</p>

-</section>

-<section id="bootstrap-values-from-newick-format" class="level2">

+</div>

+<div id="bootstrap-values-from-newick-format" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> bootstrap values from newick format</h2>

 <p>It’s quite command to store <code>bootstrap</code> value as node label in <code>newick</code> format. Visualizing node label is easy using <code>geom_text2(aes(subset = !isTip, label=label))</code>.</p>

 <p>If you want to only display a subset of <code>bootstrap</code> (e.g. bootstrap &gt; 80), you can’t simply using <code>geom_text2(subset= (label &gt; 80), label=label)</code> since <code>label</code> is a character vector, which contains node label (bootstrap value) and tip label (taxa name). If we use <code>geom_text2(subset=(as.numeric(label) &gt; 80), label=label)</code>, it will also fail since <code>NAs</code> were introduced by coercion. We need to convert <code>NAs</code> to logical <code>FALSE</code>, this can be done by the following code:</p>

@@ -85,19 +85,19 @@ d$label <- as.numeric(d$label)

 d <- d[d$label > 80,]

 q + geom_text(data=d, aes(label=label))</code></pre>

-</section>

-</section>

-<section id="aesthetic-mapping" class="level1">

+</div>

+</div>

+<div id="aesthetic-mapping" class="section level1">

 <h1><i class="fa fa-map-marker"></i> <em>aesthetic</em> mapping</h1>

-<section id="inherit-aes" class="level2">

+<div id="inherit-aes" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> inherit <em>aes</em></h2>

 <pre class="r"><code>ggtree(rtree(30)) + geom_point()</code></pre>

 <p>For example, we can add symbolic points to nodes with <code>geom_point()</code> directly. The magic here is we don’t need to map <code>x</code> and <code>y</code> position of the points by providing <code>aes(x, y)</code> to <code>geom_point()</code> since it was already mapped by <code>ggtree</code> function and it serves as a global mapping for all layers.</p>

 <p>But what if we provide a <code>dataset</code> in a layer and the <code>dataset</code> doesn’t contain column of <code>x</code> and/or <code>y</code>, the layer function also try to map <code>x</code> and <code>y</code> and also others if you map them in <code>ggtree</code> function. As these variable is not available in your <code>dataset</code>, you will get the following error:</p>

 <pre><code>Error in eval(expr, envir, enclos) : object &#39;x&#39; not found</code></pre>

 <p>This can be fixed by using parameter <code>inherit.aes=FALSE</code> which will disable inheriting mapping from <code>ggtree</code> function.</p>

-</section>

-<section id="use-in-aes" class="level2">

+</div>

+<div id="use-in-aes" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> use <code>$</code> in aes</h2>

 <p>NEVER DO THIS.</p>

 <p>see the explaination in the <a href="https://github.com/hadley/ggplot2-book/blob/master/layers.rmd#aesthetic-mappings-secaes">ggplot2 book 2ed</a>:</p>

@@ -105,12 +105,12 @@ q + geom_text(data=d, aes(label=label))</code></pre>

 <p>Never refer to a variable with <code>$</code> (e.g., <code>diamonds$carat</code>) in <code>aes()</code>. This breaks containment, so that the plot no longer contains everything it needs, and causes problems if ggplot2 changes the order of the rows, as it does when facetting.</p>

 </blockquote>

 <p>see also <a href="https://groups.google.com/forum/?utm_medium=email&amp;utm_source=footer#!msg/bioc-ggtree/hViM6vRZF94/MsZT8qRgBwAJ">1</a> and <a href="https://github.com/GuangchuangYu/ggtree/issues/106">2</a>.</p>

-</section>

-</section>

-<section id="annotation" class="level1">

+</div>

+</div>

+<div id="annotation" class="section level1">

 <h1><i class="fa fa-tree"></i> Annotation</h1>

-<section id="colouring-edges-by-user-data" class="level2">

+<div id="colouring-edges-by-user-data" class="section level2">

 <h2><i class="fa fa-angle-double-right"></i> colouring edges by user data</h2>

 <p>see my blog post: <a href="http://guangchuangyu.github.io/2016/12/edge-coloring-with-user-data/">Edge coloring with user data</a> and also my answer on <a href="https://github.com/GuangchuangYu/ggtree/issues/76" class="uri">https://github.com/GuangchuangYu/ggtree/issues/76</a> and <a href="https://groups.google.com/forum/#!topic/bioc-ggtree/4GgivKqVjB8" class="uri">https://groups.google.com/forum/#!topic/bioc-ggtree/4GgivKqVjB8</a>.</p>

-</section>

-</section>

+</div>

+</div>

@@ -9,14 +9,14 @@ weight: 30

 <p><link rel="stylesheet" href="https://guangchuangyu.github.io/css/font-awesome.min.css"></p>

 <p><a href="https://github.com/GuangchuangYu/featured_img">Let us know</a> if you have published using <code>ggtree</code> and your publication will be featured here.</p>

 <p><img src="../images/citation.png" width="880"/></p>

-<section id="section" class="level2">

+<div id="section" class="section level2">

 <h2><i class="fa fa-calendar"></i> 2017</h2>

 <p><a href="http://science.sciencemag.org/content/358/6364/789.full">Integrated view of <em>Vibrio cholerae</em> in the Americas</a>. *<strong>Science</strong>, 2017, 358(6364):789-793.</p>

 <p><a href="http://dx.doi.org/10.1073/pnas.1617959114">Phylogenetic analysis of the human antibody repertoire reveals quantitative signatures of immune senescence and aging</a>. <strong><em>PNAS</em></strong>, 2017, 114(5):1105-111-.</p>

 <p><a href="https://www.ncbi.nlm.nih.gov/pmc/articles/PMC5376617/">Horses in Denmark Are a Reservoir of Diverse Clones of Methicillin-Resistant and -Susceptible Staphylococcus aureus</a>. <strong><em>Frontiers in Microbiology</em></strong>, 2017, 8:543</p>

 <p><a href="https://microbiomejournal.biomedcentral.com/articles/10.1186/s40168-017-0232-3">Gut metagenomes of type 2 diabetic patients have characteristic single-nucleotide polymorphism distribution in <em>Bacteroides coprocola</em></a>. <strong><em>Microbiome</em></strong>, 2017, 5:15</p>

-</section>

-<section id="section-1" class="level2">

+</div>

+<div id="section-1" class="section level2">

 <h2><i class="fa fa-calendar"></i> 2016</h2>

 <p><a href="http://aem.asm.org/content/82/22/6788.short">Function and Phylogeny of Bacterial Butyryl Coenzyme A:Acetate Transferases and Their Diversity in the Proximal Colon of Swine</a>. <strong><em>Applied and Environmental Microbiology</em></strong>. 2016, 82(22):6788-6798.</p>

-</section>

+</div>

@@ -9,24 +9,24 @@ weight: 1

 <p><link rel="stylesheet" href="https://guangchuangyu.github.io/css/font-awesome.min.css"> <link rel="stylesheet" href="https://guangchuangyu.github.io/css/academicons.min.css"></p>

 <p><img src="https://raw.githubusercontent.com/Bioconductor/BiocStickers/master/ggtree/ggtree.png" height="200" align="right" /></p>

-<p><a href="https://bioconductor.org/packages/ggtree"><img src="https://img.shields.io/badge/release%20version-1.10.0-blue.svg?style=flat" alt="releaseVersion" /></a> <a href="https://github.com/guangchuangyu/ggtree"><img src="https://img.shields.io/badge/devel%20version-1.11.1-blue.svg?style=flat" alt="develVersion" /></a> <a href="https://bioconductor.org/packages/stats/bioc/ggtree"><img src="https://img.shields.io/badge/downloads-21262/total-blue.svg?style=flat" alt="total" /></a> <a href="https://bioconductor.org/packages/stats/bioc/ggtree"><img src="https://img.shields.io/badge/downloads-1156/month-blue.svg?style=flat" alt="month" /></a></p>

+<p><a href="https://bioconductor.org/packages/ggtree"><img src="https://img.shields.io/badge/release%20version-1.10.0-blue.svg?style=flat" alt="releaseVersion" /></a> <a href="https://github.com/guangchuangyu/ggtree"><img src="https://img.shields.io/badge/devel%20version-1.11.1-blue.svg?style=flat" alt="develVersion" /></a> <a href="https://bioconductor.org/packages/stats/bioc/ggtree"><img src="https://img.shields.io/badge/downloads-21911/total-blue.svg?style=flat" alt="total" /></a> <a href="https://bioconductor.org/packages/stats/bioc/ggtree"><img src="https://img.shields.io/badge/downloads-1156/month-blue.svg?style=flat" alt="month" /></a></p>

 <p>The <code>ggtree</code> package extending the <em>ggplot2</em> package. It based on grammar of graphics and takes all the good parts of <em>ggplot2</em>. <em>ggtree</em> is designed for not only viewing phylogenetic tree but also displaying annotation data on the tree. <em>ggtree</em> is released within the <a href="https://bioconductor.org/packages/ggtree/">Bioconductor</a> project and the source code is hosted on <a href="https://github.com/GuangchuangYu/ggtree"><i class="fa fa-github fa-lg"></i> GitHub</a>.</p>

-<section id="authors" class="level2">

+<div id="authors" class="section level2">

 <h2><i class="fa fa-user"></i> Authors</h2>

 <p>Guangchuang Yu and Tommy Tsan-Yuk Lam, School of Public Health, The University of Hong Kong.</p>

-</section>

-<section id="citation" class="level2">

+</div>

+<div id="citation" class="section level2">

 <h2><i class="fa fa-book"></i> Citation</h2>

 <p>Please cite the following article when using <code>ggtree</code>:</p>

-<p><a href="http://dx.doi.org/10.1111/2041-210X.12628"><img src="https://img.shields.io/badge/doi-10.1111/2041--210X.12628-blue.svg?style=flat" alt="doi" /></a> <a href="https://www.altmetric.com/details/10533079"><img src="https://img.shields.io/badge/Altmetric-336-blue.svg?style=flat" alt="Altmetric" /></a> <a href="https://scholar.google.com.hk/scholar?oi=bibs&amp;hl=en&amp;cites=7268358477862164627"><img src="https://img.shields.io/badge/cited%20by-47-blue.svg?style=flat" alt="citation" /></a></p>

+<p><a href="http://dx.doi.org/10.1111/2041-210X.12628"><img src="https://img.shields.io/badge/doi-10.1111/2041--210X.12628-blue.svg?style=flat" alt="doi" /></a> <a href="https://www.altmetric.com/details/10533079"><img src="https://img.shields.io/badge/Altmetric-333-blue.svg?style=flat" alt="Altmetric" /></a> <a href="https://scholar.google.com.hk/scholar?oi=bibs&amp;hl=en&amp;cites=7268358477862164627"><img src="https://img.shields.io/badge/cited%20by-51-blue.svg?style=flat" alt="citation" /></a></p>

 <p><strong>G Yu</strong>, DK Smith, H Zhu, Y Guan, TTY Lam<sup>*</sup>. ggtree: an R package for visualization and annotation of phylogenetic trees with their covariates and other associated data. <strong><em>Methods in Ecology and Evolution</em></strong>. 2017, 8(1):28-36.</p>

-</section>

-<section id="featured-articles" class="level2">

+</div>

+<div id="featured-articles" class="section level2">

 <h2><i class="fa fa-pencil"></i> Featured Articles</h2>

 <p><img src="https://guangchuangyu.github.io/featured_img/ggtree/2015_peiyu_1-s2.0-S1567134815300721-gr1.jpg" /></p>

 <p><i class="fa fa-hand-o-right"></i> Find out more on <i class="fa fa-pencil"></i> <a href="https://guangchuangyu.github.io/ggtree/featuredArticles/">Featured Articles</a>.</p>

-</section>

-<section id="installation" class="level2">

+</div>

+<div id="installation" class="section level2">

 <h2><i class="fa fa-download"></i> Installation</h2>

 <p>Install <code>ggtree</code> is easy, follow the guide on the <a href="https://bioconductor.org/packages/ggtree/">Bioconductor page</a>:</p>

 <pre class="r"><code>## try http:// if https:// URLs are not supported

@@ -34,18 +34,18 @@ source("https://bioconductor.org/biocLite.R")

 ## biocLite("BiocUpgrade") ## you may need this

 biocLite(&quot;ggtree&quot;)</code></pre>

 <p>If you have problems when installing some of the dependent packages, please refer to the <a href="https://github.com/GuangchuangYu/ggtree/wiki/ggtree-installation">ggtree-installation</a> wiki page.</p>

-</section>

-<section id="overview" class="level2">

+</div>

+<div id="overview" class="section level2">

 <h2><i class="fa fa-cogs"></i> Overview</h2>

-<section id="getting-tree-into-r" class="level4">

+<div id="getting-tree-into-r" class="section level4">

 <h4><i class="fa fa-angle-double-right"></i> Getting tree into R</h4>

 <ul>

 <li>tree parsers: bring evolution evidences to be used/analyzed in <code>R</code></li>

 <li><code>merge_tree</code>: allows evolution evidences to be merged and compared</li>

 <li><code>fortify</code> methods: convert tree objects into tidy data frame</li>

 </ul>

-</section>

-<section id="tree-visualization-annotation" class="level4">

+</div>

+<div id="tree-visualization-annotation" class="section level4">

 <h4><i class="fa fa-angle-double-right"></i> Tree visualization &amp; annotation</h4>

 <ul>

 <li>parsing tree as a collection of nodes allows grammar of graphics to be supported</li>

@@ -53,41 +53,41 @@ biocLite(&quot;ggtree&quot;)</code></pre>

 <li>several layers and functions for tree annotation</li>

 <li>supports annotating phylogenetic trees with user’s own data</li>

 </ul>

-</section>

-<section id="tree-manipulation" class="level4">

+</div>

+<div id="tree-manipulation" class="section level4">

 <h4><i class="fa fa-angle-double-right"></i> Tree manipulation</h4>

 <ul>

 <li>helper functions for tree manipulation, make it possible to explore the tree visually</li>

 </ul>

 <p><i class="fa fa-hand-o-right"></i> Find out details and examples on <i class="fa fa-book"></i> <a href="https://guangchuangyu.github.io/ggtree/documentation/">Documentation</a>.</p>

-</section>

-</section>

-<section id="projects-that-depend-on-ggtree" class="level2">

+</div>

+</div>

+<div id="projects-that-depend-on-ggtree" class="section level2">

 <h2><i class="fa fa-code-fork"></i> Projects that depend on <em>ggtree</em></h2>

-<section id="cran-packages" class="level4">

+<div id="cran-packages" class="section level4">

 <h4><i class="fa fa-angle-double-right"></i> CRAN packages</h4>

 <ul>

 <li><a href="https://cran.r-project.org/package=harrietr">harrietr</a>: Wrangle Phylogenetic Distance Matrices and Other Utilities</li>

 </ul>

-</section>

-<section id="bioconductor-packages" class="level4">

+</div>

+<div id="bioconductor-packages" class="section level4">

 <h4><i class="fa fa-angle-double-right"></i> Bioconductor packages</h4>

 <ul>

 <li><a href="https://www.bioconductor.org/packages/LINC">LINC</a>: co-expression of lincRNAs and protein-coding genes</li>

 <li><a href="https://www.bioconductor.org/packages/LymphoSeq">LymphoSeq</a>: Analyze high-throughput sequencing of T and B cell receptors</li>

 <li><a href="https://www.bioconductor.org/packages/philr">philr</a>: Phylogenetic partitioning based ILR transform for metagenomics data</li>

 </ul>

-</section>

-<section id="other-applications" class="level4">

+</div>

+<div id="other-applications" class="section level4">

 <h4><i class="fa fa-angle-double-right"></i> Other applications</h4>

 <ul>

 <li><a href="https://bitbucket.org/biobakery/breadcrumbs">BreadCrumbs</a>: Collection of scripts for metagenomics analysis</li>

 <li><a href="https://github.com/esnapd/DegeneratePrimerTools">DegeneratePrimerTools</a>: Utilities for Creating and Validating Degenerate primers</li>

 <li><a href="https://github.com/olli0601/phyloscan">phyloscan</a>: scan phylogenies created along a genome for patterns</li>

 </ul>

-</section>

-</section>

-<section id="feedback" class="level2">

+</div>

+</div>

+<div id="feedback" class="section level2">

 <h2><i class="fa fa-comments"></i> Feedback</h2>

 <ul class="fa-ul">

 <li>

@@ -106,4 +106,4 @@ biocLite(&quot;ggtree&quot;)</code></pre>

 <i class="fa-li fa fa-commenting"></i> Join the group chat on <a href="https://twitter.com/hashtag/ggtree"><i class="fa fa-twitter fa-lg"></i></a> and <a href="http://huati.weibo.com/k/ggtree"><i class="fa fa-weibo fa-lg"></i></a>

 </li>

 </ul>

-</section>

+</div>