hugo-sandstorm/pages/index.vue

<template>
  <div>
    <h1>hugo-sandstorm version {{hugoVersion}}</h1>
    <template v-if="isLoading">
      <p>
        Loading public site information. This may take a while!
        This is <a href="https://github.com/sandstorm-io/sandstorm/pull/3292" target="_blank" rel="noopener">a known bug</a>.
      </p>
    </template>
    <template v-else-if="loadError">
      <p>
        Unable to load public site information! Try restarting the grain.
        This is <a href="https://github.com/sandstorm-io/sandstorm/pull/3292" target="_blank" rel="noopener">a known bug</a>.
      </p>
    </template>
    <template v-else>
      <p>Your public site is available at <a :href="url" rel="noopener" target="_blank">{{ url }}</a>.</p>
      <div v-if="!isDemo">
        <p>To set up your domain to point at your public site, add the following DNS records to your domain. Replace <code>blog.example.com</code> with your site's hostname.</p>
        <table>
          <thead>
            <th>Name</th>
            <th>Type</th>
            <th>Value</th>
          </thead>
          <tbody>
            <tr>
              <td>blog.example.com</td>
              <td>CNAME</td>
              <td>{{ domain }}</td>
            </tr>
            <tr>
              <td>sandstorm-www.blog.example.com</td>
              <td>TXT</td>
              <td>{{ publicId }}</td>
            </tr>
          </tbody>
        </table>
      </div>
    </template>
    <h2>Editing Your Site</h2>
    <p>To check out the Git repository containing your site, first add an authorization key to Git:</p>
    <render-template
      rpcId="gitAuthorize"
      :template="'echo url=' + this.gitHost + ' | git -c credential.helper=store credential approve'"/>
    <p>Then run the following to clone the site:</p>
    <render-template
      rpcId="gitClone"
      :template="'git clone -c credential.helper=store ' + this.gitUrl + ' site'"/>
    <p>Here are a few pointers to help you get started:</p>
    <ul>
      <li>Choose a theme to make your site look nice. Hugo's <a target="_blank" rel="noopener" href="https://themes.gohugo.io">theme showcase</a> is a good place to start.</li>
      <li>Add the theme to your Git repository as a subtree at <code>themes/themename</code>.</li>
      <li>Add <code>theme = "themename"</code> to <code>config.toml</code>.</li>
      <li>Push the repository, and your new site will be immediately published.</li>
    </ul>
    <h2>Pushing Existing Site</h2>
    <p>If you have an existing Hugo site, run the following to publish in this grain:</p>
    <render-template
      rpcId="gitPush"
      :template="'git remote add origin ' + this.gitUrl + '\ngit push -fu origin master'"/>
    <h2>Upgrade notes from the 0.20 Sandstorm release:</h2>
    <ul>
      <li>
        If you were using inline HTML in any Markdown files, enter the following into
        your <code>config.toml</code> file:
<pre>
[markup.goldmark.renderer]
unsafe = true
</pre>
      </li>
      <li>
        There have been updates/changes to how previous/next item handling has
        changed over time. Ensure your previous/next item handling is
        working as intended.
      </li>
    </ul>
    <p>
      Be sure to <a href="https://gohugo.io/news/" target="_blank" rel="noopener">read through the Hugo release notes</a>
      if you notice any other odd behavior after upgrading. These notes will
      go away after June 1, 2020.
    </p>
    <h2>Admin Interface (<a href="https://cloudcmd.io/" target="_blank" rel="noopener">Cloud Commander</a>)</h2>
    <a :class="{disabled: !dirty}" class="button" @click="commitLocal">Commit &amp; publish local changes</a>
    <a :class="{disabled: !dirty}" class="button" @click="deleteLocal">Delete local changes (git reset --hard)</a>
    <iframe id="files" src="/admin" style="width: 100%; height: 800px; margin-top: 1rem"></iframe>
  </div>
</template>

<script>
  import "isomorphic-fetch"
  import RenderTemplate from "~components/render-template"

  export default {
    data: () => ({
      isDemo: true,
      url: "",
      domain: "",
      publicId: "",
      isLoading: true,
      loadError: null,
      dirty: false,
      hugoVersion: process.env.hugoVersion
    }),
    computed: {
      gitHost: () => {
        if(process.BROWSER_BUILD)
          return window.location.protocol+"//git:$API_TOKEN@$API_HOST"
        else
          return ""
      },
      gitUrl: () => {
        if(process.BROWSER_BUILD)
          return `${window.location.protocol}//git@$API_HOST/git`
        else
          return ""
      }
    },
    // mounted actions occur immediately. we use async here to
    // simplify promise handling.
    async mounted () {
      this.isLoading = true

      // TODO: needed until https://github.com/sandstorm-io/sandstorm/pull/3292 is merged
      let publicIdLoadTries = 5

      while (publicIdLoadTries > 0 && !this.url) {
        try {
          await this.fetchPublicId()
        } catch (e) {
          // wait 5 seconds and try again
          await new Promise((resolve) => { setTimeout(resolve, 5000) })

          publicIdLoadTries -= 1

          if (publicIdLoadTries === 0) {
            this.loadError = e
          }
        }
      }

      this.isLoading = false

      setInterval(this.checkDirty, 5000)
    },
    head: {
      title: "Home"
    },
    methods: {
      async fetchPublicId () {
        try {
          const result = await fetch("/publicId", {
            credentials: "same-origin"
          })
          const jsonResult = await result.json()
          this.isDemo = jsonResult.isDemo
          this.url = jsonResult.url
          this.publicId = jsonResult.publicId
          this.domain = jsonResult.domain
        } catch (e) {
          console.error(e)
          throw e
        }
      },
      async commitLocal () {
        if (!this.dirty) return

        if (confirm('Are you sure?')) {
          await fetch('/commit')
        }
      },
      async deleteLocal () {
        if (!this.dirty) return

        if (confirm('Are you sure?')) {
          await fetch('/reset-local')

          document.getElementById('files').contentWindow.location.reload(true)
        }
      },
      async checkDirty () {
        const response = await fetch('/dirty')
        const json = await response.json()

        if (json.hasOwnProperty('dirty')) {
          this.dirty = json.dirty
        }
      }
    },
    components: {RenderTemplate}
  }

</script>