Improving our landing page (#396)

* Improved landing page
This commit is contained in:
Irfan Alibay
2023-05-06 13:54:21 +01:00
committed by GitHub
parent d7bf903b76
commit 7cfb0fa983
11 changed files with 123 additions and 10 deletions

1
docs/_static/API.svg vendored Normal file
View File

@@ -0,0 +1 @@
<svg width="480" height="480" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><defs><clipPath id="clip0"><rect x="358" y="131" width="480" height="480"/></clipPath></defs><g clip-path="url(#clip0)" transform="translate(-358 -131)"><path d="M530.95 453.05 473.85 396 530.95 338.95 545.05 353.05 502.15 396 545.05 438.95 530.95 453.05Z"/><path d="M665.05 453.05 650.95 438.95 693.85 396 650.95 353.05 665.05 338.95 722.15 396 665.05 453.05Z"/><path d="M564.507 452.61 612.343 337.179 630.819 344.836 582.983 460.266Z"/><path d="M398 216 398 526 798 526 798 216ZM743 246C748.523 246 753 250.477 753 256 753 261.523 748.523 266 743 266 737.477 266 733 261.523 733 256 733 250.477 737.477 246 743 246ZM708 246C713.523 246 718 250.477 718 256 718 261.523 713.523 266 708 266 702.477 266 698 261.523 698 256 698 250.477 702.477 246 708 246ZM673 246C678.523 246 683 250.477 683 256 683 261.523 678.523 266 673 266 667.477 266 663 261.523 663 256 663 250.477 667.477 246 673 246ZM768 496 428 496 428 296 768 296Z"/></g></svg>

After

Width:  |  Height:  |  Size: 1.1 KiB

1
docs/_static/CLI.svg vendored Normal file
View File

@@ -0,0 +1 @@
<svg width="480" height="480" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><defs><clipPath id="clip0"><rect x="298" y="120" width="480" height="480"/></clipPath></defs><g clip-path="url(#clip0)" transform="translate(-298 -120)"><path d="M422.5 434.5 408.5 420.5 451.5 377.5 408.5 334.5 422.5 320.5 479.5 377.5Z"/><path d="M338 205 338 515 738 515 738 205 338 205ZM683 235C688.5 235 693 239.5 693 245 693 250.5 688.5 255 683 255 677.5 255 673 250.5 673 245 673 239.5 677.5 235 683 235ZM648 235C653.5 235 658 239.5 658 245 658 250.5 653.5 255 648 255 642.5 255 638 250.5 638 245 638 239.5 642.5 235 648 235ZM613 235C618.5 235 623 239.5 623 245 623 250.5 618.5 255 613 255 607.5 255 603 250.5 603 245 603 239.5 607.5 235 613 235ZM708 485 368 485 368 285 708 285 708 485Z"/><path d="M488 415 568 415 568 435 488 435Z"/></g></svg>

After

Width:  |  Height:  |  Size: 897 B

1
docs/_static/Cookbook.svg vendored Normal file
View File

@@ -0,0 +1 @@
<svg width="480" height="480" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><defs><clipPath id="clip0"><rect x="510" y="100" width="480" height="480"/></clipPath></defs><g clip-path="url(#clip0)" transform="translate(-510 -100)"><path d="M755 425C755 430.523 750.523 435 745 435 739.477 435 735 430.523 735 425 735 419.477 739.477 415 745 415 750.523 415 755 419.477 755 425Z"/><path d="M795 425C795 430.523 790.523 435 785 435 779.477 435 775 430.523 775 425 775 419.477 779.477 415 785 415 790.523 415 795 419.477 795 425Z"/><path d="M755 465C755 470.523 750.523 475 745 475 739.477 475 735 470.523 735 465 735 459.477 739.477 455 745 455 750.523 455 755 459.477 755 465Z"/><path d="M795 465C795 470.523 790.523 475 785 475 779.477 475 775 470.523 775 465 775 459.477 779.477 455 785 455 790.523 455 795 459.477 795 465Z"/><path d="M891.5 387.5C873 372 851 363 828 354.5L803.5 344.5C801.5 343.5 800.5 342 800.5 340L800.5 328C819.5 313 830.5 290 830.5 265.5L830.5 235.5 830.5 235.5 830.5 220.5C852.5 204 857 172.5 840.5 150.5 829 135 810 128 791 131.5 775 109 744 104 721.5 120 717 123 713 127 710 131.5 683 126.5 656.5 144 651.5 171 647.5 189.5 655 208.5 670 220L670 250 670 250 670 265C670 289 681 312 700 327.5L700 340C700 342 699 344 697 344.5L672.5 354.5C649.5 362.5 627.5 372 609 387.5 597 396.5 590.5 410 590 425L590 513 594.5 516C619 532.5 685.5 540.5 751.5 540.5 818 540.5 884 532 906 515.5L910 512.5 910 425C909.5 410 903 396.5 891.5 387.5ZM700 150C707.5 150 714.5 153 720 158 721 141.5 735.5 129 752 130.5 767 131.5 778.5 143.5 779.5 158 792 147 810.5 148 822 160 833 172.5 832 191 820 202.5 817 205 813.5 207 810 208.5L810 230 690 230 690 208.5C674.5 203 666.5 186 672 170 676 158 687.5 150 700 150ZM690 265 690 250 810 250 810 265C810 298 783 325 750 325 717 325 690 298 690 265ZM750 345C760.5 345 770.5 343 780 339L780 339.5C780 347 783.5 354.5 789.5 359.5 777 363.5 763.5 365 750 365 736.5 365 723 363 710 359.5 716 355 719.5 347.5 719.5 339.5L719.5 339C729.5 343 739.5 345 750 345ZM610 425C610 416 614.5 408 621.5 402.5 638 389 658 380.5 679 373L679 373 679.5 372.5C682 371.5 684 371 686.5 370 687.5 370.5 689 371.5 690 372L690 517C655.5 514 625.5 509 610 501L610 425ZM890 502C862.5 517 780 522.5 710 519L710 380C723 383.5 736.5 385 750 385 775.5 385 798.5 379.5 813.5 370.5 816 371.5 818 372 820.5 373L821.5 373.5 821.5 373.5C842.5 381 862.5 389.5 879 403 886 408.5 890 416.5 890 425L890 502Z"/></g></svg>

After

Width:  |  Height:  |  Size: 2.4 KiB

1
docs/_static/Download.svg vendored Normal file
View File

@@ -0,0 +1 @@
<svg width="192" height="192" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><defs><clipPath id="clip0"><rect x="309" y="101" width="192" height="192"/></clipPath></defs><g clip-path="url(#clip0)" transform="translate(-309 -101)"><path d="M446 189 421 189 421 133 389 133 389 189 364 189 405 237Z"/><path d="M455 213 455 249 355 249 355 213 343 213 343 261 467 261 467 213Z"/></g></svg>

After

Width:  |  Height:  |  Size: 456 B

1
docs/_static/Rocket.svg vendored Normal file
View File

@@ -0,0 +1 @@
<svg width="480" height="480" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><defs><clipPath id="clip0"><rect x="364" y="152" width="480" height="480"/></clipPath></defs><g clip-path="url(#clip0)" transform="translate(-364 -152)"><path d="M803 194C796 187 751 195 713.5 205 727 213 741 224 754.5 237.5 768.5 251.5 779.5 265.5 787.5 279.5 797.5 241 810.5 201 803 194Z"/><path d="M524.5 336.5 507.5 330C500.5 327.5 493 329 487.5 334L408 413.5C395 426.5 407 449 425 445L491.5 430C497 405 506 371.5 524.5 336.5Z"/><path d="M657 467C623.5 484.5 591.5 494 565.5 499L550 570C546 588 568 600.5 581.5 587L661 507.5C666 502.5 668 494.5 665 487.5L657 467Z"/><path d="M686.5 214C657 226 623.5 246.5 591 279 531.5 338.5 514 410.5 509 451.5L540 482.5C581 477.5 653.5 460.5 713 401 745.5 368.5 766 335.5 778 306 771.5 289.5 758.5 270 740 251 722 233.5 703 220.5 686.5 214ZM712 322C700.5 333.5 681.5 333.5 669.5 322 658 310.5 658 291.5 669.5 279.5 681 268 700 268 712 279.5 723.5 291.5 723.5 310.5 712 322Z"/><path d="M508.5 483C500.5 475 501.5 461.5 485 478 468.5 494.5 444 532 451.5 540 459.5 548 497 523 513.5 506.5 530 489.5 516.5 490.5 508.5 483Z"/></g></svg>

After

Width:  |  Height:  |  Size: 1.2 KiB

21
docs/_static/Squaredcircle.svg vendored Normal file
View File

@@ -0,0 +1,21 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<svg xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:cc="http://creativecommons.org/ns#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:svg="http://www.w3.org/2000/svg" xmlns="http://www.w3.org/2000/svg" xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" width="12pt" height="12pt" viewBox="0 0 12 12" version="1.1" id="svg7" sodipodi:docname="Aluminium symbol (Dalton).svg" inkscape:version="0.92.5 (2060ec1f9f, 2020-04-08)">
<metadata id="metadata13">
<rdf:RDF>
<cc:Work rdf:about="">
<dc:format>image/svg+xml</dc:format>
<dc:type rdf:resource="http://purl.org/dc/dcmitype/StillImage"/>
</cc:Work>
</rdf:RDF>
</metadata>
<defs id="defs11"/>
<sodipodi:namedview pagecolor="#ffffff" bordercolor="#666666" borderopacity="1" objecttolerance="10" gridtolerance="10" guidetolerance="10" inkscape:pageopacity="0" inkscape:pageshadow="2" inkscape:window-width="1920" inkscape:window-height="1015" id="namedview9" showgrid="false" inkscape:zoom="29.5" inkscape:cx="7.6460489" inkscape:cy="12.40678" inkscape:window-x="0" inkscape:window-y="0" inkscape:window-maximized="1" inkscape:current-layer="svg7" inkscape:snap-midpoints="true" inkscape:snap-smooth-nodes="false" inkscape:snap-object-midpoints="true" inkscape:object-nodes="false" inkscape:snap-center="true"/>
<path inkscape:connector-curvature="0" id="path4" d="M 3.5,10.330127 C 5.8917186,11.710986 8.9492676,10.891719 10.330127,8.5 11.710986,6.1082814 10.891719,3.0507326 8.5,1.669873 8.1062276,1.4425284 7.6944069,1.2748211 7.2749922,1.1639499 6.8555775,1.0530788 6.4285687,0.99904383 6.0044201,0.99904383 5.140459,0.99904383 4.2883648,1.2232394 3.5364896,1.6479568 2.7846143,2.0726741 2.1329581,2.6979131 1.669873,3.5 0.28901359,5.8917186 1.1082814,8.9492676 3.5,10.330127 Z" style="fill:none;stroke:#000000;stroke-width:0.3;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:5.5;stroke-opacity:1;stroke-dasharray:none" sodipodi:nodetypes="ssssssss"/>
<path style="fill:none;stroke:#000000;stroke-width:0.3;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:5.5;stroke-dasharray:none;stroke-opacity:1" d="M 1.6787134,8.4999997 10.330127,8.5" id="path819" inkscape:connector-curvature="0" sodipodi:nodetypes="cc"/>
<path style="fill:none;stroke:#000000;stroke-width:0.3;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:5.5;stroke-dasharray:none;stroke-opacity:1" d="M 6.0044201,0.99904383 8.1672735,4.7495219 10.330127,8.5" id="path819-1" inkscape:connector-curvature="0" sodipodi:nodetypes="ccc"/>
<path style="fill:none;stroke:#000000;stroke-width:0.3;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:5.5;stroke-dasharray:none;stroke-opacity:1" d="M 6.0044201,0.99904383 3.8415668,4.7495218 1.6787134,8.4999997" id="path819-1-2" inkscape:connector-curvature="0" sodipodi:nodetypes="ccc"/>
<path style="fill:none;stroke:#000000;stroke-width:0.3;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:5.5;stroke-dasharray:none;stroke-opacity:1" d="m 3.9968952,4.4843827 4.01505,10e-8" id="path819-1-7" inkscape:connector-curvature="0" sodipodi:nodetypes="cc"/>
<path style="fill:none;stroke:#000000;stroke-width:0.3;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:5.5;stroke-dasharray:none;stroke-opacity:1" d="m 3.9968952,4.4843827 -10e-8,4.0150499" id="path819-1-7-3" inkscape:connector-curvature="0" sodipodi:nodetypes="cc"/>
<path style="fill:none;stroke:#000000;stroke-width:0.3;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:5.5;stroke-dasharray:none;stroke-opacity:1" d="m 8.0119452,4.4843828 -10e-8,4.0150498" id="path819-1-7-3-6" inkscape:connector-curvature="0" sodipodi:nodetypes="cc"/>
<path inkscape:connector-curvature="0" id="path4-0" d="M 5.0009246,8.2307259 C 5.9609564,8.7850011 7.1882513,8.4561481 7.7425258,7.4961165 8.2967998,6.5360847 7.9679475,5.30879 7.0079159,4.7545153 6.8498564,4.6632593 6.6845523,4.5959422 6.5161999,4.5514387 6.3478476,4.5069347 6.1764471,4.4852457 6.0061945,4.4852457 c -0.3467924,0 -0.6888216,0.089992 -0.990623,0.2604725 C 4.7137701,4.9161989 4.4521965,5.1671688 4.2663148,5.4891251 3.7120404,6.4491567 4.0408932,7.6764515 5.0009246,8.2307259 Z" style="fill:none;stroke:#000000;stroke-width:0.3;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:5.5;stroke-dasharray:none;stroke-opacity:1" sodipodi:nodetypes="ssssssss"/>
</svg>

After

Width:  |  Height:  |  Size: 4.4 KiB

1
docs/_static/Tutorial.svg vendored Normal file
View File

@@ -0,0 +1 @@
<svg width="480" height="480" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><defs><clipPath id="clip0"><rect x="280" y="100" width="480" height="480"/></clipPath></defs><g clip-path="url(#clip0)" transform="translate(-280 -100)"><path d="M508.05 440.7C508.05 453.237 497.887 463.4 485.35 463.4 472.813 463.4 462.65 453.237 462.65 440.7 462.65 428.163 472.813 418 485.35 418 497.887 418 508.05 428.163 508.05 440.7Z"/><path d="M530 515 530 492.3C529.926 488.763 528.276 485.443 525.5 483.25 518.977 478.222 511.513 474.55 503.55 472.45 497.539 470.605 491.288 469.661 485 469.65 478.719 469.747 472.479 470.689 466.45 472.45 458.575 474.781 451.152 478.434 444.5 483.25 441.724 485.443 440.074 488.763 440 492.3L440 515Z"/><path d="M607.35 440.7C607.35 453.237 597.187 463.4 584.65 463.4 572.113 463.4 561.95 453.237 561.95 440.7 561.95 428.163 572.113 418 584.65 418 597.187 418 607.35 428.163 607.35 440.7Z"/><path d="M630 515 630 492.3C629.926 488.763 628.276 485.443 625.5 483.25 618.977 478.222 611.513 474.55 603.55 472.45 597.539 470.605 591.287 469.661 585 469.65 578.719 469.747 572.479 470.689 566.45 472.45 558.575 474.781 551.152 478.434 544.5 483.25 541.724 485.443 540.074 488.763 540 492.3L540 515Z"/><path d="M707.35 440.7C707.35 453.237 697.187 463.4 684.65 463.4 672.113 463.4 661.95 453.237 661.95 440.7 661.95 428.163 672.113 418 684.65 418 697.187 418 707.35 428.163 707.35 440.7Z"/><path d="M730 515 730 492.3C729.926 488.763 728.276 485.443 725.5 483.25 718.977 478.222 711.513 474.55 703.55 472.45 697.539 470.605 691.287 469.661 685 469.65 678.719 469.747 672.479 470.689 666.45 472.45 658.575 474.781 651.152 478.434 644.5 483.25 641.724 485.443 640.074 488.763 640 492.3L640 515Z"/><path d="M417.1 230.8C417.1 247.203 403.803 260.5 387.4 260.5 370.997 260.5 357.7 247.203 357.7 230.8 357.7 214.397 370.997 201.1 387.4 201.1 403.803 201.1 417.1 214.397 417.1 230.8Z"/><path d="M562.55 219.35C559.61 216.452 554.89 216.452 551.95 219.35L487.35 283.95C482.188 282.493 476.639 283.904 472.8 287.65 471.75 288.7 453.1 319.2 453.1 319.2L447.5 295.35C446.758 292.275 445.224 289.448 443.05 287.15 433.835 279.701 423.229 274.16 411.85 270.85 403.806 269.13 395.622 268.142 387.4 267.9 379.104 268.028 370.863 269.272 362.9 271.6 351.419 274.61 340.768 280.183 331.75 287.9 329.556 290.184 328.019 293.016 327.3 296.1 327.3 296.1 305.75 386.6 305.75 388.1 305.75 396.385 312.466 403.1 320.75 403.1 327.389 402.93 333.125 398.414 334.85 392L350.45 327.45 350.45 535 380 535 380 401.45 395 401.45 395 535 424.5 535 424.5 326.5 430 350C430.382 351.625 431.461 352.997 432.95 353.75 438.7 358.163 445.704 360.632 452.95 360.8 457.668 361.461 462.343 359.337 464.95 355.35L495.45 305.35C497.4 302.276 498.131 298.585 497.5 295L562.5 230C565.444 227.068 565.466 222.309 562.55 219.35Z"/><path d="M665 150 420 150C408.954 150 400 158.954 400 170L400 188C407.645 190.081 414.566 194.234 420 200L420 170 665 170 665 335 494.35 335 482.15 355 665 355C676.046 355 685 346.046 685 335L685 170C685 158.954 676.046 150 665 150Z"/></g></svg>

After

Width:  |  Height:  |  Size: 3.0 KiB

1
docs/_static/UserGuide.svg vendored Normal file
View File

@@ -0,0 +1 @@
<svg width="480" height="480" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><defs><clipPath id="clip0"><rect x="395" y="100" width="480" height="480"/></clipPath></defs><g clip-path="url(#clip0)" transform="translate(-395 -100)"><path d="M825 210 825 455 445 455 445 210 415 210 415 490 590 490C590 498.5 596.5 505 605 505L665 505C673.5 505 680 498.5 680 490L855 490 855 210 825 210Z"/><path d="M805 180 465 180 465 435 805 435 805 180ZM495 210 625 210 625 405 495 405 495 210ZM775 405 645 405 645 210 775 210 775 405Z"/><path d="M675 260 745 260 745 275 675 275Z"/><path d="M675 290 745 290 745 305 675 305Z"/><path d="M675 320 723.5 320 723.5 335 675 335Z"/></g></svg>

After

Width:  |  Height:  |  Size: 741 B

View File

@@ -23,7 +23,6 @@ project = 'OpenFE'
copyright = '2022, The OpenFE Development Team'
author = 'The OpenFE Development Team'
# -- General configuration ---------------------------------------------------
# Add any Sphinx extension module names here, as strings. They can be
@@ -35,7 +34,8 @@ extensions = [
'sphinx_click.ext',
'sphinxcontrib.autodoc_pydantic',
'sphinx_toolbox.collapse',
'sphinx.ext.autosectionlabel'
'sphinx.ext.autosectionlabel',
'sphinx_design',
]
autoclass_content = 'both'
@@ -69,6 +69,20 @@ autodoc_mock_imports = ['openff.models',
# a list of builtin themes.
#
html_theme = 'pydata_sphinx_theme'
html_theme_options = {
"logo": {
"text": "OpenFE Documentation"
},
"icon_links": [
{
"name": "Github",
"url": "https://github.com/OpenFreeEnergy/openfe",
"icon": "fa-brands fa-square-github",
"type": "fontawesome",
}
]
}
html_logo = "_static/Squaredcircle.svg"
# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,

View File

@@ -11,6 +11,8 @@ dependencies:
- python=3.9
- sphinx
- sphinx-click
- openff-models>=0.0.5
- pip:
- sphinx-design
- sphinx-toolbox
- git+https://github.com/OpenFreeEnergy/gufe@main

View File

@@ -1,14 +1,83 @@
.. OpenFE documentation master file, created by
sphinx-quickstart on Fri Feb 25 13:54:41 2022.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
.. template taken from SciPy who took it from Pandas (keep the chain going)
.. module:: openfe
====================================
Welcome to the OpenFE documentation!
====================================
**Useful Links**:
`OpenFE Website <https://openfree.energy/>`__ |
`Example Tutorial notebooks <https://github.com/OpenFreeEnergy/ExampleNotebooks/>`__ |
`Source Repository <https://github.com/OpenFreeEnergy/openfe/>`__ |
`Issues & Ideas <https://github.com/OpenFreeEnergy/openfe/issues/>`__
The **OpenFE** toolkit provides open-source frameworks for calculating alchemical free energies.
.. grid:: 1 2 3 4
:gutter: 3
.. grid-item-card:: Installing OpenFE
:img-top: _static/Download.svg
:text-align: center
:link: installation
:link-type: doc
New to *OpenFE*? Check out our installation guide to get it working on your machine!
.. grid-item-card:: Tutorials
:img-top: _static/Tutorial.svg
:text-align: center
:link: tutorials/index
:link-type: doc
Worked through examples of how to use the OpenFE toolkit.
.. grid-item-card:: User Guide
:img-top: _static/UserGuide.svg
:text-align: center
:link: guide/index
:link-type: doc
Learn about the underlying concepts of the OpenFE toolkit.
.. grid-item-card:: API Reference
:img-top: _static/API.svg
:text-align: center
:link: reference/index
:link-type: doc
Get details on the toolkit's core methods and classes.
.. grid-item-card:: Cookbook
:img-top: _static/Cookbook.svg
:text-align: center
:link: cookbook/index
:link-type: doc
How-to guides on how to utilise the toolkit components.
.. grid-item-card:: Using the CLI
:img-top: _static/CLI.svg
:text-align: center
:link: guide/cli
:link-type: doc
Reference guide on using the OpenFE CLI.
.. grid-item-card:: Relative Free Energy Protocol
:img-top: _static/Rocket.svg
:text-align: center
:link: reference/api/openmm_rfe
:link-type: doc
Documentation for OpenFE's OpenMM-based Hybrid Topology Relative Free
Energy Protocol.
Welcome to OpenFE's documentation!
==================================
.. toctree::
:maxdepth: 2
:caption: Contents:
:hidden:
installation
tutorials/index
@@ -17,7 +86,7 @@ Welcome to OpenFE's documentation!
reference/index
Indices and tables
==================
------------------
* :ref:`genindex`
* :ref:`modindex`