[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Publishing_Directory_Options.tex

[raeburn]

raeburn		Fri Jun  4 14:46:52 2021 EDT

  Added files:                 
    /loncom/html/adm/help/tex	Publishing_Directory_Options.tex 
  Log:
  - Document options when publishing  directory
  
  

Index: loncom/html/adm/help/tex/Publishing_Directory_Options.tex
+++ loncom/html/adm/help/tex/Publishing_Directory_Options.tex
\label{Publishing_Directory_Options}
By default, pushing the ``Publish Directory'' button will:
\begin{itemize}
\item
Publish all currently unpublished resources in the directory.

\item
Re-publish all resources for which the last modified time
of the file in Authoring Space postdates that of the latest
version of the published file (in Resource Space).

\item
Re-publish all resources for which the last modified time
of the resource's metadata file in Authoring Space postdates
that of the latest version of the published metadata file
(in Resource Space).

\end{itemize}

For unpublished resources the metadata used will be the 
directory level metadata.  For previously published 
resources, the existing metadata will be used, updated with a
new ``modification time'', and also with the keywords recommended
by LON-CAPA, if no keywords are present in the current metadata file.

The ``Options'' panel provides checkboxes to override the defaults,
including the ability to recursively publish any sub-directories.

Options to use for two particular use cases are as follows:

\begin{itemize}
\item
Only modification is to copyright/distribution for published resources.
Check the following:

\begin{enumerate}

\item include subdirectories
\item exclude currently unpublished files
\item exclude modified files
\item exclude files with modified metadata
\item apply common copyright/distribution

\end{enumerate}

\item
Only modification is to source availability for published resources.
Check the same items as above, except replace:
``apply common copyright/distribution'' with ``apply common source availability''.

\end{itemize}

As publication proceeds, LON-CAPA will display a list of any resources which
have been omitted from publication, any why.